Định vị IP API
Quốc gia, vùng, thành phố, tọa độ và múi giờ cho bất kỳ địa chỉ IPv4 hoặc IPv6 công cộng nào. Dùng MaxMind GeoLite2 — tính toán hoàn toàn cục bộ, không có giới hạn tần suất dùng chung.
Chưa có API key?
Đăng nhập vào tài khoản để tạo và quản lý API key của bạn.
Hướng dẫn tích hợp
Sao chép một đoạn mã, thay API key của bạn, chạy. Hoạt động với mọi HTTP client — các ví dụ bên dưới bằng cURL, JavaScript và Python.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringtùy chọnPublic IPv4 or IPv6 address. Omit to look up caller's own IP. 8.8.8.8
curl -X GET "https://www.apipick.com/api/ip-geolocation" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}Xây dựng cho các trường hợp sử dụng thực tế
Phát hiện gian lận
Đánh dấu các lượt đăng ký hoặc giao dịch từ vùng rủi ro cao. Kiểm tra xem IP của người dùng có khớp với vị trí họ khai báo hoặc quốc gia thanh toán hay không.
Bản địa hóa nội dung
Tự động chọn ngôn ngữ, tiền tệ và giá theo vùng dựa trên vị trí khách truy cập. Chỉ hiển thị banner cookie tuân thủ EU cho khách EU.
Giới hạn tần suất
Áp dụng giới hạn tần suất hoặc kiểm soát truy cập theo từng quốc gia. Chặn hoặc bóp lưu lượng từ các vùng cụ thể mà không cần mua công cụ bảo mật đắt tiền.
Làm giàu cho AI Agent
Để AI agent làm giàu hồ sơ người dùng, phân loại lead theo địa lý, hoặc bản địa hóa nội dung được tạo dựa trên dữ liệu IP thời gian thực.
Lựa chọn thay thế ipinfo.io & ipapi.co
Tính phí credit theo tài khoản — không có pool giới hạn tần suất dùng chung, không có tầng gói, không có hạn mức hằng tháng tự đặt lại vào ngày đầu tháng.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Gói miễn phí | 50k req/month | 1,000 req/day | 100 credit khi đăng ký |
| Mô hình giới hạn tần suất | Rủi ro pool IP dùng chung | Rủi ro pool IP dùng chung | Credit theo tài khoản |
| Credit / hạn mức hết hạn? | Đặt lại hằng tháng | Đặt lại hằng ngày | Không bao giờ hết hạn |
| Quốc gia + vùng + thành phố | ✓ | ✓ | ✓ |
| Múi giờ | Gói trả phí | ✓ | ✓ |
| Hỗ trợ IPv6 | ✓ | ✓ | ✓ |
| Cờ thành viên EU | Gói trả phí | ✓ | ✓ |
| Không cần thẻ tín dụng để bắt đầu | ✓ | ✓ | ✓ |
| Sẵn sàng cho AI agent / LLM | Một phần | Một phần | ✓ JSON gốc |
Vấn đề pool giới hạn tần suất dùng chung
Với gói miễn phí của ipinfo.io và ipapi.co, giới hạn tần suất được áp dụng theo từng IP client. Điều đó nghĩa là mọi request từ cùng một vùng Vercel, AWS hay GCP đều dùng chung một pool hạn mức. Nếu một tenant khác trên cùng edge node đã dùng hết hạn mức 1.000 mỗi ngày, các lệnh gọi API của bạn bắt đầu thất bại — dù bạn chưa thực hiện request nào.
Tính phí theo credit: đoán trước được ở mọi quy mô
API Pick tính phí theo tài khoản, không theo IP. Mỗi lượt gọi trừ đúng 1 credit từ số dư của bạn — chỉ khi phản hồi thành công. Credit không bao giờ hết hạn. Dù bạn tra cứu 10 hay 10.000 lần trong một ngày, bạn chỉ trả cho những gì mình dùng mà không có rủi ro thất bại bất ngờ từ một hạn mức dùng chung.
Các trường phản hồi
| Trường | Kiểu | Mô tả |
|---|---|---|
| data.ip | string | Địa chỉ IP đã truy vấn |
| data.country_code | string | Mã quốc gia ISO 3166-1 alpha-2 (ví dụ US, DE, JP) |
| data.country_name | string | Tên đầy đủ tiếng Anh của quốc gia |
| data.continent | string | Tên châu lục (ví dụ North America, Europe) |
| data.continent_code | string | Mã châu lục hai chữ cái (ví dụ NA, EU) |
| data.city | string | Tên thành phố (chuỗi rỗng nếu không có) |
| data.latitude | number | null | Vĩ độ xấp xỉ của vị trí IP |
| data.longitude | number | null | Kinh độ xấp xỉ của vị trí IP |
| data.timezone | string | Định danh múi giờ IANA (ví dụ America/Los_Angeles) |
| data.currency | string | Mã tiền tệ ISO 4217 cho quốc gia (ví dụ USD, EUR) |
| data.isp | string | Tên ISP / tổ chức từ cơ sở dữ liệu ASN |
| data.asn | integer | null | Autonomous System Number (ví dụ 15169 cho Google) |
| credits_used | integer | Credit bị trừ cho request này |
| remaining_credits | integer | Credit còn lại trong tài khoản của bạn |
Giới hạn tần suất
Giới hạn tốc độ tính theo từng API key, cửa sổ trượt 60 giây. Vượt giới hạn, bạn nhận được phản hồi 429 sạch sẽ kèm header Retry-After.
120req/min
Theo từng API key, từng endpoint. Cửa sổ trượt 60 giây.
3concurrent
Số request đang chạy tối đa đồng thời cho mỗi API key.
X-RateLimit-LimitSố request tối đa cho phép mỗi phútX-RateLimit-RemainingSố request còn lại trong cửa sổ hiện tạiX-RateLimit-ResetSố giây cho đến khi cửa sổ hiện tại được đặt lạiRetry-AfterSố giây cần chờ trước khi thử lại (chỉ khi 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Câu hỏi thường gặp
Hỏi: Điều gì xảy ra nếu tôi không truyền địa chỉ IP?
Đáp: Endpoint tự động phát hiện IP của bên gọi từ header của request (X-Forwarded-For). Điều này hữu ích cho các tra cứu phía máy chủ khi bạn muốn định vị người dùng cuối mà không cần truyền IP rõ ràng.
Hỏi: IP riêng tư có được hỗ trợ không?
Đáp: Không. IP riêng tư (các dải RFC 1918 như 192.168.x.x, 10.x.x.x), loopback (127.0.0.1) và các dải dành riêng khác trả về lỗi 400. Chỉ các địa chỉ IPv4 và IPv6 định tuyến công cộng được hỗ trợ.
Hỏi: Định vị chính xác đến mức nào?
Đáp: Dùng MaxMind GeoLite2-City. Độ chính xác cấp quốc gia thường là 95–99%. Độ chính xác cấp thành phố thay đổi theo vùng — nhìn chung đáng tin cậy ở Bắc Mỹ và Châu Âu, kém chính xác hơn ở một số khu vực châu Á và châu Phi. Tọa độ đại diện cho khu vực chung, không phải vị trí vật lý chính xác.
Hỏi: AI agent có thể dùng cái này làm tool không?
Đáp: Có. Endpoint nhận một tham số truy vấn ip tùy chọn duy nhất và trả về một object JSON phẳng — dễ dàng phơi ra làm hàm tool cho OpenAI, Claude, LangChain hay bất kỳ framework agent nào. Hữu ích cho các agent cần suy luận về vị trí người dùng, áp dụng quy tắc theo địa lý hoặc làm giàu dữ liệu lead với ngữ cảnh vùng.
Dùng IP Geolocation trong Claude Code & AI Agent
Cài đặt skill Claude Code chính thức để định vị bất kỳ địa chỉ IP nào ngay trong agent code AI của bạn — quốc gia, thành phố, ISP, múi giờ và hơn thế qua ngôn ngữ tự nhiên.
Hỏi AI agent của bạn một cách tự nhiên
Nền tảng tương thích
Skill Claude Code cho API IP Geolocation của APIpick
Trả về quốc gia, châu lục, thành phố, vĩ độ/kinh độ, múi giờ IANA, mã tiền tệ ISO, tên ISP và ASN cho bất kỳ địa chỉ IP nào.