ドキュメント

API

HTTP・JSON API

認証不要

主要エンドポイントはアカウントも Cookie も不要です。動的レスポンスは Cache-Control: no-store とレート制限ヘッダーを使用します。

API v1

安定版 JSON

安定したレスポンス契約を持つ、自己および対象検索用のバージョン付き snake_case JSON。

GET/api/v1/self

ネットワーク、位置、ASN フィールドを含む現在の IP の構造化結果。

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

検証済み IPv4 または IPv6 アドレスの構造化検索結果。

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

互換性

パス	レスポンス
`GET /`	コンテンツネゴシエーション対応：CLI と / は JSON、text/plain は IP 1 件、明示的な text/html は SSR ページを返します。
`GET /json`	ネットワーク、位置、ASN フィールドを含む現在の IP の構造化結果。
`GET /json/{ip}`	検証済み IPv4 または IPv6 アドレスの構造化検索結果。
`GET /ip/{ip}`	機械クライアントには正規化した対象 IP、明示的な HTML 要求には noindex の検索ページを返します。

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

ターミナル

TEXT / ANSI

パス	レスポンス
`GET /ip`	正規化した現在の IP と改行 1 文字。
`GET /info[/{ip}]`	安定した項目順で ANSI 制御文字を含まない詳細な UTF-8 テキスト。
`GET /ansi[/{ip}]`	/info に許可済み SGR 色を明示的に適用した表示。
`GET /field/{field}[/{ip}]`	許可された単一値と改行。値がなければ 204。

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

測定方法とシグナルの境界

このサービスは、サーバーが観測したネットワーク情報、ローカル地理データ、ブラウザー側の証拠を分けて扱い、異なる信号を混同しません。

表示されるパブリック IP は、この HTTP 接続でサービスが観測したアドレスです。
国、地域、都市、タイムゾーン、座標、ASN、組織名はローカルデータセットから取得します。
WebRTC、DNS、言語、タイムゾーン、IPv6 の各テストは、ブラウザー側で独立して観測されます。
利用不可、不明、未観測、不一致はそれぞれ異なる状態です。

精度とデータの鮮度

IP 位置情報はネットワークの割り当てを示すもので、端末や世帯の所在地ではありません。都市や座標が実際の場所から離れる場合があり、精度半径は保証ではなく不確実性の目安です。

プライバシーと保存期間

検索処理は生の IP、URI、ヘッダー、フィンガープリントを PostgreSQL 集計へ保存しません。署名付き共有リンクは縮約した状態値だけを含み、24 時間で失効し、共有レコードとして保存されません。

よくある質問

表示された都市は正確な現在地ですか？

いいえ。IP 位置情報はネットワーク単位の概算です。精度半径を確認し、端末や住所の正確な位置として扱わないでください。

IP 検索はデータベースに保存されますか？

アプリケーションは利用状況集計に生の IP アドレスを保存しません。制限された Web アクセスログは別の保持方針で管理されます。

IPv6 が「利用不可」ではなく「不明」になるのはなぜですか？

未設定、遮断、判定不能の測定だけでは IPv6 がないとは証明できないため、明確な結果が得られるまで不明のままです。

診断共有リンクには何が含まれますか？

縮約した状態値、発行時刻、失効時刻、署名だけです。IP、座標、DNS リゾルバーアドレスは含みません。