POST AI agent ready /v1/ip/bulk

一括 IP 地理位置情報 API - 無料のバッチ検索

1 つのリクエストで複数の IP アドレスの地理位置情報データを返します。要求された各 IP の結果とともに、発信者自身の IP 情報が含まれます。

Endpoint

curl -X POST https://api.botoi.com/v1/ip/bulk \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

When to use this API

1 日分の分析イベントを収集した後、一意の訪問者 IP を抽出し、バルクエンドポイント経由で送信します。地理レポート用にデータウェアハウスに読み込む前に、国と都市のデータを各イベント行に追加します。

サーバー、CDN ノード、ロードバランサー IP のリストをこのエンドポイントにフィードします。返された座標を地図上にプロットして、インフラストラクチャのフットプリントを視覚化し、カバレッジ内の地理的なギャップを特定します。

1 回のリクエストで送信できる IP 数はいくつですか?

リクエストごとに最大 100 個の IP アドレスを送信できます。データセットが大きい場合は、データセットをバッチに分割し、複数のリクエストを送信します。

応答には自分の IP が含まれますか?

はい。応答には、ips 配列内の各 IP の結果に加えて、自分の IP の地理位置情報を含む caller_ip フィールドが含まれます。

アレイ内の重複 IP は処理されますか?

重複した IP は個別に解決されます。 ips 配列の各エントリは、同じ IP が複数回出現する場合でも、独自の結果オブジェクトを取得します。

バッチ内の 1 つの IP が無効な場合はどうなりますか?

エンドポイントは、すべての有効な IP の結果を返し、解決できなかった IP についてはエラーメッセージを含みます。 1 つの不正なエントリが原因でリクエストが完全に失敗するわけではありません。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.