IP 地理位置 API
查詢任意公網 IPv4 或 IPv6 位址的國家、地區、城市、座標與時區。由 MaxMind GeoLite2 提供 — 完全本機運算,無共用速率限制。
整合指南
複製程式碼片段，替換你的 API 金鑰，執行即可。適用於任何 HTTP 用戶端——下方提供 cURL、JavaScript 與 Python 範例。
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstring選填Public 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
}為實際使用情境打造
詐騙偵測
標記來自高風險地區的註冊或交易。檢查使用者的 IP 是否與其聲稱的所在地或帳單國家相符。
內容在地化
依訪客所在地自動選擇語言、貨幣與區域定價。僅對歐盟訪客顯示符合歐盟規範的 Cookie 橫幅。
速率限制
套用依國家的速率限制或存取控制。無需購買昂貴的安全工具,即可封鎖或限制來自特定地區的流量。
AI 智慧代理增強
讓 AI 智慧代理依即時 IP 資料增強使用者紀錄、依地理位置分類潛在客戶,或在地化所產生的內容。
ipinfo.io 與 ipapi.co 的替代方案
依帳號計算點數 — 無共用的速率限制池、無方案分級,也沒有每月第一天就重置的月度上限。
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| 免費方案 | 50k req/month | 1,000 req/day | 註冊即享 100 點 |
| 速率限制模式 | 共用 IP 池風險 | 共用 IP 池風險 | 依帳號計點 |
| 點數 / 額度會過期嗎? | 每月重置 | 每日重置 | 永不過期 |
| 國家 + 地區 + 城市 | ✓ | ✓ | ✓ |
| 時區 | 付費方案 | ✓ | ✓ |
| IPv6 支援 | ✓ | ✓ | ✓ |
| 歐盟成員國標記 | 付費方案 | ✓ | ✓ |
| 免信用卡即可開始 | ✓ | ✓ | ✓ |
| AI 智慧代理 / LLM 即用 | 部分支援 | 部分支援 | ✓ 原生 JSON |
共用速率限制池的問題
在 ipinfo.io 與 ipapi.co 的免費方案中,速率限制是 依用戶端 IP計算的。這代表來自同一個 Vercel、AWS 或 GCP 地區的所有請求,共用同一個額度池。如果同一個邊緣節點上的另一個租戶已經用光每日 1,000 次的上限,您的 API 呼叫就會開始失敗 — 即使您自己連一個請求都還沒發出。
依點數計費:任何規模都可預測
API Pick 是 依帳號計費,而非依 IP。每次呼叫只會從您的餘額中扣除剛好 1 點 — 且僅在回應成功時才扣。點數永不過期。無論您一天查詢 10 次還是 10,000 次,都只為實際用量付費,完全不必擔心因共用額度而意外失敗。
回應欄位
| 欄位 | 類型 | 說明 |
|---|---|---|
| data.ip | string | 查詢的 IP 位址 |
| data.country_code | string | ISO 3166-1 alpha-2 國碼(如 US、DE、JP) |
| data.country_name | string | 完整的英文國名 |
| data.continent | string | 洲名(如 North America、Europe) |
| data.continent_code | string | 兩字母的洲代碼(如 NA、EU) |
| data.city | string | 城市名稱(若無則為空字串) |
| data.latitude | number | null | IP 所在地的概略緯度 |
| data.longitude | number | null | IP 所在地的概略經度 |
| data.timezone | string | IANA 時區識別碼(如 America/Los_Angeles) |
| data.currency | string | 該國的 ISO 4217 貨幣代碼(如 USD、EUR) |
| data.isp | string | 來自 ASN 資料庫的 ISP / 組織名稱 |
| data.asn | integer | null | 自治系統編號(如 Google 的 15169) |
| credits_used | integer | 本次請求扣除的點數 |
| remaining_credits | integer | 您帳戶中剩餘的點數 |
速率限制
限流以 API 金鑰計，採用 60 秒滑動視窗。觸發限制時會回傳乾淨的 429，並帶 Retry-After 回應標頭。
120req/min
以 API 金鑰、以端點計。60 秒滑動視窗。
3concurrent
每個 API 金鑰同時進行中的最大請求數。
X-RateLimit-Limit每分鐘允許的最大請求數X-RateLimit-Remaining目前視窗內剩餘的請求數X-RateLimit-Reset目前視窗重設前的秒數Retry-After重試前需等待的秒數（僅在 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
}常見問題
問: 如果我不傳入 IP 位址會怎樣?
答: 此端點會從請求標頭(X-Forwarded-For)自動偵測呼叫端的 IP。這在伺服器端查詢時很有用 — 您想為終端使用者定位,卻不必明確傳入 IP。
問: 支援私有 IP 嗎?
答: 不支援。私有 IP(RFC 1918 範圍,如 192.168.x.x、10.x.x.x)、迴路位址(127.0.0.1)與其他保留範圍都會回傳 400 錯誤。僅支援公網可路由的 IPv4 與 IPv6 位址。
問: 地理位置的準確度如何?
答: 由 MaxMind GeoLite2-City 提供。國家層級的準確度通常為 95–99%。城市層級的準確度因地區而異 — 在北美與歐洲通常可靠,在亞洲與非洲部分地區較不精確。座標代表大致區域,而非精確的實體位置。
問: AI 智慧代理可以將此當作工具使用嗎?
答: 可以。此端點接受單一可選的 ip 查詢參數,並回傳扁平的 JSON 物件 — 可輕鬆作為 OpenAI、Claude、LangChain 或任何智慧代理框架的函式工具公開。適合需要推理使用者位置、實施地理規則或為潛在客戶資料補上區域脈絡的智慧代理。
在 Claude Code 與 AI 智慧代理中使用 IP 地理位置
安裝官方 Claude Code 技能,即可在您的 AI 編碼智慧代理中直接為任意 IP 位址定位 — 透過自然語言取得國家、城市、ISP、時區等資訊。
用自然語言詢問您的 AI 智慧代理
相容平台
APIpick IP 地理位置 API 的 Claude Code 技能
為任意 IP 位址回傳國家、洲、城市、經緯度、IANA 時區、ISO 貨幣代碼、ISP 名稱與 ASN。