API リファレンス

リクエスト元クライアントの公開IPアドレスのみを、プレーンテキスト(Content-Type: text/plain)で返します — 例: 73.9.114.155。ipinfo.io/ip の直接的な代替であり、curl、Wget、HTTPie、または通常のブラウザアクセスのいずれからでも同じように動作します(上記の curl ipto.to ショートカットとは異なり、User-Agentによる検出は行いません)。ブラウザで開いた場合も、ページ装飾なしでIPアドレスそのものだけが表示されます。

パラメータ・クエリ文字列は不要です。完全なジオロケーション/脅威インテリジェンスオブジェクトが必要な場合は、下記の GET /v1/ip を使用してください。このルートは接続元IPを直接読み取るため(D1/KVの検索は行いません)、1日あたりのリクエスト予算にはカウントされません — 詳細はレート制限を参照してください。

リクエスト元IPのジオロケーションおよび脅威インテリジェンスを返します。CFエッジオブジェクトによる都市レベルのデータも含まれます。

必須パラメータはありません。?lang=、?fields=、?format= を指定できます — 詳細は下記のローカライゼーションおよび出力フォーマットを参照してください。

任意のIPv4アドレスを検索します。都市レベルのフィールド(city、state、postal_code、latitude、longitude、timezone)は、そのIPが統合された2つのジオデータセット(IP2LocationまたはMaxMind)のいずれかに該当する場合に入力されます — レスポンス内の geo_precision を確認することで、都市レベルか国レベルのデータかを判別できます。timezone のフォーマットはどちらのソースが一致したかによって異なります(IP2Locationの場合はUTCオフセット文字列、MaxMindの場合はIANA名)。IPv6の検索は現時点では国レベルのデータのみを返します。

ホームページの検索バーの背後にある統合検索エンドポイントです。:query がIP、ASN(AS15169 または 15169)、2文字の国コード、メールアドレス、電話番号のいずれであるかを検出し、関連するすべてのチェックを1つのレスポンスに集約します。IPクエリの場合、サーバー側で並行して、主要なIP検索に加えてRPKI、IP-to-company、モバイルキャリア、ホストされているドメイン、周辺情報の検索にファンアウトします。そのため、1回の検索で消費されるのは機能ごとに1件ずつではなく、1日のレート制限予算に対する1リクエスト分のみです。

各サブフィールドは個別に劣化します — アップストリーム(RIPEstat、RDAPサーバー、crt.sh)が遅延または失敗した場合、そのフィールドのみが null になり、検索全体が失敗することはありません。プライマリクエリ自体が無効な場合(例: 不正な形式のIP)にのみ、リクエスト全体としてエラーステータスが返されます。

逆引きDNS — DNS-over-HTTPSによる単発のライブPTR検索であり、ドメイン列挙データベースではありません。IPにPTRレコードがない場合は null を返します。

IPが現在アナウンスしているルートに対するRPKIルートオリジン検証で、RIPEstat経由でライブに解決されます(ROAデータベースの取り込みやローカルでの同期は行いません)。status は "valid"、"invalid"、"unknown" のいずれかのみであり、他のシグナルから合成されることはありません。RIPEstatの失敗やタイムアウトが発生した場合は、エラーではなく理由の文字列とともに "unknown" が返されます。

明示的な(ASN、プレフィックス)によるRPKI検証です — 上記のIPベースの簡易チェックとは異なり、確認したい正確なルートをすでに把握している場合に使用します。

RDAP(構造化WHOIS)の登録者データとASN自体の組織名を組み合わせることで、IPが登録されている組織を特定します。信頼度はカテゴリ形式で示され、数値スコアではありません。

RDAP登録レコードそのものです — ネットワークブロック、登録日/最終変更日、RDAPに記録されているすべての連絡先を含みます。上記の /company は同じ登録者データをASNの組織名と照合して信頼度付きの単一の回答にまとめますが、このエンドポイントは生のレコードをそのまま返すもので、従来のWHOIS出力に近い形式です。IPv6アドレスにも対応しています。

モバイルネットワークに分類されたIPに対するベストエフォートのモバイルキャリア識別で、MCC/MNCオペレーターディレクトリと照合されます。単一の carrier フィールドは意図的に設けていません — 下記の matched_carrier_entries と note を参照してください — 単純なキャリア名を返すと、加入者単位のライブな判定であるかのように読めてしまいますが、このデータではそこまで正直に保証できないためです。

IPの逆引きDNS(PTR)ホスト名と証明書透明性ログ(crt.sh)を通じて、そのIPに関連するドメインを検出します — 一般的な逆引きIP検索ではありません。レスポンス内の limitations フィールドで、検出できる内容とできない内容が具体的に説明されています。

一括検索 — リクエストあたり最大100件のIPまで対応、Pro/Enterprise限定です。各IPをキーとしたオブジェクトを返します。キャッシュとデータベースの読み取りを並行して行うため、逐次呼び出しよりも高速です。バッチ内の各IPは、個別に検索した場合と同様に1日のリクエスト予算にカウントされます。無料プランでのリクエストは403になります — 詳細は料金ページを参照してください。

自律システム番号(ASN)で検索します。組織名、国、大陸、IP範囲数、分類種別、為替レート、およびロケール参照データ(言語、TLD、首都、国境)を返します。

IPの都市レベルの位置情報を逆ジオコーディングし、周辺の関心地点(レストラン、公園、学校、交通機関、著名なランドマーク)、データソースが存在する地域の犯罪データ(英国・米国のみ)、およびオプションのオンデマンド通勤時間(車)の見積もりを返します。

国レベルの集計統計に加え、ロケール参照データ(通貨、為替レート、言語、TLD、首都、国境)を返します。

User-Agent文字列を解析します。ブラウザ、OS、デバイス種別、ボット検出結果を返します。デフォルトでは呼び出し元の User-Agent ヘッダーを読み取りますが、?ua= で任意の文字列を渡すこともできます。

電話番号の検証とフォーマットを常に無料で行います: 地域、回線種別、E.164/国内/国際形式でのフォーマットを、自社ホストのパーサーで処理し、ベンダー呼び出しはありません。IP/キーごとの月間プレミアム予算が利用可能な場合(Freeで月100件、有料プランではさらに多く — 料金を参照)、同じリクエストがリアルタイムキャリア照会サービスから、ライブのキャリア名、ポータビリティステータス、プロバイダーによって分類された電話タイプも追加で返します — sourceと以下のフィールドを参照してください。ローカライズされたcountry_nameとlang/lang_sourceは、階層に関係なく常に含まれます — ローカライゼーションを参照してください。この予算を使い切った場合や、アップストリームで問題が発生した場合は、上記の無料フィールドにシームレスにフォールバックします。そのためにリクエストが失敗することはありません。番号ごとの照会ではなく、国レベルのネットワークオペレーター参照データについては、代わりにGET /v1/carriersを参照してください。

一括検証です。/v1/ip/bulk とは異なり、すべてのプランで一括アクセスが利用できます — 無料プランを制限しているのは403ではなく、プランごとのバッチ上限です。Free: 10件/リクエスト、100件/日。Pro: 100件/リクエスト、1,000件/日。Enterprise: 1,000件/リクエスト、10,000件/日。この予算は通常の1日あたりのリクエスト上限とは別枠です — 詳細はレート制限を参照してください。

参照用の検索です: 特定の国について既知のモバイルネットワークオペレーター(MCC/MNC)を返します — 特定の電話番号には紐づいていません。コミュニティが管理するMCC/MNCの一覧(MITライセンス、2026年に最終同期 — 詳細はdocsリポジトリを参照)を情報源としています。番号計画の割り当ては頻繁には変わらないため、ライブフィードではなく静的な参照テーブルとしています。

メールアドレスの構文検証、DNS-over-HTTPSによるライブのMXレコードチェック、およびコミュニティが管理するブロックリスト(CC0ライセンス、毎日同期)による使い捨て/一時ドメインの検出を行います。メールボックス自体の存在は検証しません — それにはこのAPIが行わないSMTPハンドシェイクが必要です(has_mx が証明する内容としない内容の詳細は、下記のフィールドリファレンスを参照してください)。

提供されたIP、メールアドレス、電話番号、User-Agentのうち、渡された項目を組み合わせて0〜100の単一スコアを算出します — これはip-api.com、ipapi.co、ipgeolocation.io、ipify.org、ipregistry.co、ip2location.io、AbstractAPI、IPLocate.io、BigDataCloudのいずれも(直接確認した限り)単一の統合シグナルとしては提供していない機能です。4つの入力はすべてオプションかつ独立しており、任意の組み合わせで渡すことができます。ip を省略した場合は自分自身のIP、ua を省略した場合は自分自身のUser-Agentヘッダーがデフォルトとして使用されます。これは GET /v1/ip および GET /v1/ua と同じ規則です。渡さなかったシグナルはレスポンスから単に除外されるだけで、クリーンとして採点されることはありません — その重みは実際に提供されたシグナルに再配分されます。

実際のヘッドレスChromeインスタンス(Cloudflare Browser Renderingを使用しており、サードパーティのスクリーンショットベンダーではありません)でURLをレンダリングし、PNGを返します。内部/プライベートな対象(localhost、RFC 1918の範囲、リンクローカル/クラウドメタデータアドレス)は、ブラウザが起動する前に拒否されます。Browser Rendering自体のプラットフォームレベルの制限を受け、これは本APIの他の部分よりもはるかに厳しいものです — 下位のCloudflareプランでは、通常の1日あたりのリクエスト予算に達するよりも先にスロットリングされることを想定してください。

ローカルのトライグラム頻度解析によってテキストの言語を識別します — 外部ベンダーの呼び出し、AIモデルによる推論、ログ記録は一切行いません。10文字未満の入力では language が null になります。約30文字未満でも推測結果は返されますが、reliable は false になります。

2つの通貨(154通貨に対応)間で金額を変換します。すべてのIP、ASN、国検索における currency_code/exchange_rate_usd を支えているのと同じ日次の基準レートフィードを使用しており — ジオロケーションレスポンスにネストする形ではなく、独立した変換エンドポイントとしてここに公開しています。

対応するあらゆる通貨(USDに限りません)を基準に再計算した、全通貨(154通貨)分の為替レート表。

1つの通貨ペアについて、過去最大90日分の日次基準レート履歴です — 通貨コンバーターツールのレート推移チャートの背後にあるデータです。一度バックフィルされた後、GET /v1/currency/convert を更新するのと同じcronによって毎日追記されます。これは時系列の単一の日次基準レートであり、売買スプレッドではありません。

地名、郵便番号、"lat,lon" のペア、または lat + lon、ip に対する現在の気象状況を返します — detail=1 を指定すると、時間ごとの見通しと複数日の予報も追加されます。米国の地点は米国立気象局(National Weather Service)、それ以外はMET Norwayが提供します。include= を付けると、単位指定、最大9日間、太陽と月、公式警報などを含む完全なドキュメントが返ります — 下の include カードを参照してください。weather-lookup ツールは、このエンドポイントを明示的に呼び出す前に、ブラウザ側で呼び出し元自身の位置も自動検出します。

8桁のシリアル番号による出願状況を取得するため、USPTOのTrademark Status & Document Retrieval(TSDR)システムへライブでプロキシします — キャッシュや再販されたコピーではなく、リクエストごとの直接呼び出しです。出願状況データは米国政府の著作物であり、USPTO自身の利用規約によりパブリックドメインとされているため、無断でキャッシュ・再販するのではなく、すべてのレスポンスに source/attribution フィールドが付与されます。商標のロゴ/画像データは意図的に対象外です — USPTOの規約では、画像のライセンスはこのエンドポイントが返す出願状況のテキストデータとは別に扱われています。登録番号による検索はまだ対応していません。現時点でUSPTOが文書化しているのはシリアル番号によるパスのみです。商標検索ツールで試すことができます。

7〜8桁の実用特許番号による付与状況を取得するため、USPTOのPatent File Wrapper API(Open Data Portal)へライブでプロキシします — キャッシュや再販されたコピーではなく、リクエストごとの直接呼び出しです。当初想定していたソース(PatentsViewのSearch API)は2026-03-20に停止したことが確認されたため、代わりにそのライブの後継サービスへプロキシしています。Patent File Wrapperのデータは米国政府の著作物であり、USPTO自身の利用規約によりパブリックドメインとされているため、すべてのレスポンスに source/attribution フィールドが付与されます。対象範囲は出願/審査手続き中心です — Lens.org、Espacenet、Google Patentsのような引用グラフ、パテントファミリー、法的ステータスフィールド、画像は含まれません。対象範囲は2001年以降に出願されたものからです。意匠特許、植物特許、再発行特許は現時点では未対応です。対応するのは付与済みの特許番号による実用特許のみです。特許検索ツールで試すことができます。

ページネーション対応のVPN、Tor、脅威インテリジェンスフィードです。1ページあたり200件のエントリを含みます。各エントリには IP/CIDR、プロバイダーのアトリビューション、ISP、国、分類種別が含まれます。

メタデータのみを返します — 総エントリ数、ソースごとの件数、最終同期時刻。IPデータは返しません。

ページネーション対応の不正利用ネットワーク範囲です。複数フィード間の裏付けにより1〜10でスコア化されます。リスク階層: critical(8-10)、high(5-7)、medium(3-4)。

メタデータのみを返します — 総ネットワーク数、ソースごとの件数、リスク階層の内訳、最終同期時刻。

このAPIがすでに基盤としているオープンデータセットのダウンロード可能なCSVエクスポートです — 同一のデータであり、新たなライセンスは発生しません。asn と ranges は常に利用可能です。geo-city は、そのソースのデータセットが該当デプロイで有効になるまで503を返します。geo-city は統合ビューではなく、一度に1つのジオソースの生データ行をエクスポートします — ?source=primary(デフォルト)または ?source=secondary を指定してください。

APIキーを即座に発行します — メールアドレスも登録も不要です。すべてのキーはFreeプラン(1日1,000リクエスト、一括検索は含まれません)から開始します。ProおよびEnterpriseキーでは、より高い1日あたりの上限と一括検索(リクエストあたり最大100件のIP)が利用可能になります — 詳細は料金ページを参照してください。キーは保存しておいてください — 後から取得することはできません。

あるキーがこれまでに行ったリクエスト数を確認します。任意の /v1/* リクエストで X-API-Key ヘッダーまたは ?api_key= を通じてキーを渡すと、そのリクエストがカウントされます。

IPを所有するネットワークの不正利用報告先を RDAP から取得します。RIR、ネットワークハンドル、該当するCIDR、abuse用メールボックスを返します。報告の送信先を知るために使います。

レジストリに接続できなかった場合、available は false になります(理由は failure に入ります)。

ASNが実際にアナウンスしているIP範囲をページ分割で返します。各範囲に国と、ホスティング / モバイル / 住宅 / ボット / ブラックリストのフラグが付きます。

ASNのレジストリ(RDAP)情報: ハンドル、名前、国、割り当て種別、登録日、RIRと連絡先。

レジストリに接続できない場合、available は false になり、reason が付きます。

このASNに関連しそうな他のASN。まず同じ登録組織、次に同じ国と種別の順です。

ASNが実際にどこにあるか: 最大クラスの範囲をサンプリングして市区町村レベルで位置を割り出した点と、最も多い都市。ASNページの分布マップに使われます。

サンプルであり、範囲の全リストではありません。すべての範囲は /v1/asn/:asn/ranges を使ってください。

ASN内でホストされているドメイン。アドレスのサンプルに対する逆引きDNS(PTR)で検出します。各エントリにはルートドメイン、PTRホスト名、サンプルしたIPが含まれます。

サンプリングのため、ASNが何をホストしているかの目安であり、完全な一覧ではありません。単一のIPには /v1/ip/:ip/hosted-domains を使ってください。

ASNのBGP関係: ピア、アップストリームプロバイダー、ダウンストリームの顧客と、それぞれの件数。

BGPデータソースに接続できなかった場合、available は false になります。available: true で配列が空なら、そのASNについて報告がなかったことを意味します。

IPv4空間のディレクトリ: /8ブロックごとに1エントリで、含まれる範囲・国・ASNの数と最多の国を返します。ここから始めて /v1/ip-ranges/:a と /v1/ip-ranges/:a/:b で掘り下げます。

1つの/8(例: 8.0.0.0/8)の中にある/16ブロック。ブロックごとの範囲・国・ASNの数も同様に返します。

1つの/16(例: 8.8.0.0/16)の中の割り当て済み範囲。それぞれが属するASNと、ブロックごとの件数も返します。

座標に対する Nearby ペイロードの一部分。クライアントが届いた部分から順に描画できます: 逆ジオコーディング、周辺の関心地点、地域の犯罪統計。

2地点間の車での所要時間と距離。高速パス: /v1/places/:ip が行う逆ジオコーディングと周辺施設の検索を省略します。

目的地を解決できない場合、レスポンスは to: null、commute: null、reason 文字列になります。

IPではなく入力した住所を起点にした /v1/places/:ip のペイロード: ジオコード、ローカリティ、任意の通勤時間の推定。

住所をジオコーディングできなかった場合、found は false になります。

住所のオートコンプリート: 入力途中の住所に一致する場所をいくつか返します。特定の地点を優先することもできます。

地名、郵便番号、座標、またはIPに対する完全な気象ドキュメントです。include で必要なブロックを選びます: current、hourly、daily、astro(太陽と月)、solar、indicators、alerts、marine、air_quality、nowcast、またはall。米国の地点は米国立気象局(National Weather Service)、それ以外はMET Norwayのデータで、どちらかは meta.source でわかります。include を省略すると、上記の簡易形式 { query, weather } が返ります。

meta.coverage は、その地点で利用できるフィールドを示します。降水確率、突風、雷の確率は米国と北欧のみで、それ以外では null(0ではありません)になります。alerts は米国とノルウェーの公式警報です。marine、air_quality、nowcast はノルウェーと近海のみが対象で、それ以外は available: false になります。meta.derived にあるものはipto.toによる推定値で、indicators は導出されたフラグであり公式の警報ではありません。データを表示する場合は meta.attribution を残してください(MET Norwayのデータは CC BY 4.0 です)。

すでに照会された地点について、ipto.to が独自に記録した日次データです。その日の予報スナップショットの中での最高気温の最大値、最低気温の最小値、降水量の最大値を保持します。データがあるのは過去に照会された地点のみで、時間とともに蓄積されます。

これらは予報のスナップショットであり、観測所の観測値や再解析ではないため、観測された履歴として使わないでください。404 は、その地点のスナップショットがまだ記録されていないことを意味します。

利用可能なレーダーアニメーションのフレームを古い順に返します。各フレームにUnixタイムスタンプと、レーダータイルURLで使うフレームIDが付きます。

標準的なウェブマップの z/x/y 位置における、1フレーム分のレーダーマップタイル(PNG)。同一オリジンで配信されるため、マップはサードパーティへのリクエストなしで読み込めます。

標準的なウェブマップの z/x/y 位置の衛星画像マップタイル。同一オリジンで配信されます。

/v1/email/:email 向けの機械可読なOpenAPI 3.1仕様。LLMやMCPエージェントがこのドキュメントを読まずにメールエンドポイントを呼び出せるように書かれています。