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が申告した所在地や請求先の国と一致するかを確認できます。
コンテンツのローカライズ
訪問者の所在地に基づいて、言語、通貨、地域別価格を自動的に選択します。EU準拠のCookieバナーをEUの訪問者だけに表示することもできます。
レート制限
国ごとのレート制限やアクセス制御を適用します。高価なセキュリティツールを購入することなく、特定の地域からのトラフィックをブロックまたは制限できます。
AIエージェントのデータ拡充
AIエージェントにリアルタイムのIPデータに基づいてユーザーレコードを拡充させたり、地理情報でリードを分類させたり、生成コンテンツをローカライズさせたりできます。
ipinfo.io & ipapi.co の代替
アカウント単位のクレジット課金 — 共有のレート制限プールも、プランの段階も、月初にリセットされる月間上限もありません。
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| 無料枠 | 50k req/month | 1,000 req/day | 登録時に100クレジット |
| レート制限モデル | 共有IPプールのリスク | 共有IPプールのリスク | アカウント単位のクレジット |
| クレジット／クォータの有効期限は？ | 毎月リセット | 毎日リセット | 無期限 |
| 国 + 地域 + 市 | ✓ | ✓ | ✓ |
| タイムゾーン | 有料プラン | ✓ | ✓ |
| IPv6対応 | ✓ | ✓ | ✓ |
| EU加盟フラグ | 有料プラン | ✓ | ✓ |
| 開始にクレジットカード不要 | ✓ | ✓ | ✓ |
| AIエージェント／LLM対応 | 一部対応 | 一部対応 | ✓ ネイティブJSON |
共有レート制限プールの問題
ipinfo.io や ipapi.co の無料枠では、レート制限が クライアントIPごとに課されます。つまり、同じVercel、AWS、GCPのリージョンからのすべてのリクエストが1つのクォータプールを共有することになります。同じエッジノード上の別のテナントが既に1日1,000回の上限を使い切っていれば、あなたがまだ1度もリクエストしていなくても、APIコールは失敗し始めます。
クレジットベースの課金: どんな規模でも予測可能
API Pickは IP単位ではなくアカウント単位で課金します。すべてのコールは — 成功したレスポンスの場合のみ — 残高からちょうど1クレジットを差し引きます。クレジットに有効期限はありません。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 | 2文字の大陸コード（例 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秒のスライディングウィンドウです。上限に達すると、Retry-Afterヘッダー付きのクリーンな429が返されます。
120req/min
APIキー単位・エンドポイント単位。60秒のスライディングウィンドウ。
3concurrent
APIキーごとの同時進行リクエストの最大数。
X-RateLimit-Limit1分あたりに許可される最大リクエスト数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
}よくある質問
Q: IPアドレスを渡さなかった場合はどうなりますか？
A: エンドポイントはリクエストヘッダー（X-Forwarded-For）から呼び出し元のIPを自動検出します。これは、IPを明示的に渡さずにエンドユーザーをジオロケーションしたいサーバーサイドの検索に便利です。
Q: プライベートIPには対応していますか？
A: いいえ。プライベートIP（192.168.x.x、10.x.x.x などのRFC 1918範囲）、ループバック（127.0.0.1）、その他の予約済み範囲は400エラーを返します。公開ルーティング可能なIPv4およびIPv6アドレスのみに対応しています。
Q: ジオロケーションの精度はどれくらいですか？
A: MaxMind GeoLite2-City搭載です。国レベルの精度は通常95〜99%です。市レベルの精度は地域によって異なります — 一般に北米やヨーロッパでは信頼性が高く、アジアやアフリカの一部ではやや精度が落ちます。座標は正確な物理的位置ではなく、おおよそのエリアを示します。
Q: AIエージェントはこれをツールとして利用できますか？
A: はい。エンドポイントは任意の ip クエリパラメータを1つ受け取り、フラットなJSONオブジェクトを返すため、OpenAI、Claude、LangChain、その他あらゆるエージェントフレームワークのファンクションツールとして簡単に公開できます。ユーザーの所在地について推論したり、地理ベースのルールを適用したり、リードデータを地域的なコンテキストで拡充したりする必要があるエージェントに役立ちます。
Claude Code & AIエージェントでIPジオロケーションを使う
公式のClaude Codeスキルをインストールすれば、AIコーディングエージェントの中から直接、任意のIPアドレスをジオロケーションできます — 自然言語で国、市、ISP、タイムゾーンなどを取得。
AIエージェントに自然に尋ねる
対応プラットフォーム
APIpick IPジオロケーションAPI向けのClaude Codeスキル
任意のIPアドレスについて、国、大陸、市、緯度／経度、IANAタイムゾーン、ISO通貨コード、ISP名、ASNを返します。