Phân loại IP (cloud, Tor, bot) API
IP có thuộc AWS, Google Cloud, Azure, Cloudflare hay hosting khác, là nút Tor exit hay Googlebot / Bingbot thật? Dữ liệu chính thức, cập nhật mỗi ngày.
Truyền một ip (IPv4 hoặc IPv6) để biết IP có thuộc mạng cloud, hosting hay CDN không (Amazon Web Services, Google Cloud, Microsoft Azure, Oracle Cloud, Cloudflare, DigitalOcean, Akamai / Linode, Vultr) kèm dịch vụ và vùng nếu được công bố, có đang là nút Tor exit không, và có phải crawler hay fetcher đã xác minh không: Googlebot và các crawler đặc biệt của Google, Bingbot, Applebot, GPTBot, OAI-SearchBot, ChatGPT-User, DuckDuckBot, PerplexityBot, CCBot. Mọi dải khớp được liệt kê trong matches, dải hẹp nhất trước.
Gửi kèm ua (User-Agent) của request để bắt bot giả: khi UA tự nhận là một trong các crawler này nhưng IP nằm ngoài dải đã công bố của crawler đó, user_agent.genuine là false và mức rủi ro là cao. dns=true chạy thêm bước kiểm tra DNS ngược + DNS xuôi mà Google và Bing khuyến nghị. risk đưa ra mức gợi ý (Tor hoặc crawler giả là cao, lưu lượng từ trung tâm dữ liệu là trung bình) kèm lý do. Gửi POST ips để kiểm tra tối đa 1000 địa chỉ.
Mọi nguồn đều là file do chính nhà cung cấp công bố (ip-ranges.json, cloud.json, Azure Service Tags, googlebot.json, danh sách Tor exit…), cập nhật hằng ngày; sources=true liệt kê các nguồn kèm số dải. VPN thương mại và proxy dân cư không công bố dải IP nên không phát hiện được. Để biết vị trí và ASN hãy dùng /v1/ip.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
ip | query|path | string | không | Địa chỉ IPv4 hoặc IPv6. Cũng nhận trên đường dẫn: /v1/ip-intel/66.249.66.1. | |
ips | body | array | không | Hàng loạt: tối đa 1000 địa chỉ. | |
ua | query|body | string | không | User-Agent của request, để kiểm tra việc tự nhận là crawler. | |
dns | query|body | boolean | không | false | Kiểm tra thêm DNS ngược + DNS xuôi (tối đa 20 IP mỗi lần tra hàng loạt). |
sources | query|body | boolean | không | false | Thêm danh sách nguồn dữ liệu kèm URL và số dải. |
Ví dụ
curl "https://apibox.io.vn/v1/ip-intel?ip=66.249.66.1&ua=Mozilla/5.0%20(compatible;%20Googlebot/2.1)" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/ip-intel?ip=66.249.66.1&ua=Mozilla/5.0%20(compatible;%20Googlebot/2.1)', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/ip-intel?ip=66.249.66.1&ua=Mozilla/5.0%20(compatible;%20Googlebot/2.1)",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/ip-intel?ip=66.249.66.1&ua=Mozilla/5.0%20(compatible;%20Googlebot/2.1)');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"ip": "66.249.66.1",
"valid": true,
"version": 4,
"is_cloud": false,
"cloud": null,
"is_tor_exit": false,
"is_crawler": true,
"crawler": {
"name": "Googlebot",
"operator": "Google",
"type": "crawler",
"cidr": "66.249.66.0/27",
"verified_by": "official IP ranges"
},
"google_network": true,
"user_agent": {
"claims": "Google crawler",
"genuine": true
},
"risk": {
"level": "low",
"reasons": [
"Verified Googlebot (official IP ranges)"
]
},
"matches": [
{
"cidr": "66.249.66.0/27",
"source": "googlebot",
"provider": "Google",
"category": "crawler",
"bot": "Googlebot",
"service": null,
"region": null
},
{
"cidr": "66.249.64.0/19",
"source": "google",
"provider": "Google",
"category": "network",
"service": null,
"region": null
}
],
"data_version": "202611110259",
"built_at": "2026-11-11T02:59:02.917Z",
"note": "Classification from the providers' own published IP range files (refreshed daily). Commercial VPNs and residential proxies publish no ranges and are not detected."
}
Ứng dụng
- Chặn lạm dụng đăng ký, thanh toán đến từ trung tâm dữ liệu hoặc Tor
- Phát hiện Googlebot / Bingbot giả trong access log và khi phân tích SEO
- Cho crawler đã xác minh đi qua lớp chống bot và giới hạn tốc độ
- Gắn nhãn lưu lượng analytics là cloud, crawler hay người dùng thật
Hỏi đáp
Có phát hiện được VPN không?
Chỉ VPN đặt trên các cloud trong danh sách mới hiện là lưu lượng cloud. VPN thương mại và mạng proxy dân cư không công bố dải IP nên không phát hiện được.
Crawler được xác minh thế nào?
Theo file dải IP chính thức của từng đơn vị vận hành crawler; với dns=true còn kiểm tra DNS ngược (ví dụ *.googlebot.com) và xác nhận bằng DNS xuôi.
Dữ liệu dải IP mới tới đâu?
Mọi nguồn được tải và kiểm tra hằng ngày; data_version và built_at cho biết thời điểm.
API liên quan
Tạo mã hash
Tính MD5, SHA-1, SHA-256, SHA-384, SHA-512 và CRC32 của chuỗi hoặc file trong một lần gọi, xuất hex hoặc base64, hỗ trợ ký HMAC.
B64Mã hoá / Giải mã
Mã hoá hoặc giải mã chuỗi sang Base64, Base64URL, hex, URL encode, HTML entity, Unicode escape, ROT13 hay nhị phân chỉ với một lần gọi API.
***Tạo mật khẩu
Tạo mật khẩu ngẫu nhiên an toàn bằng CSPRNG (4–256 ký tự, tối đa 100 cái mỗi lần) hoặc kiểm tra độ mạnh, entropy và thời gian bẻ khoá của mật khẩu.