よくある質問

無料のIPインテリジェンスAPIです。任意のIPv4またはIPv6アドレスを検索すると、国、ASN、ISP、ホスティング判定、VPN検出、Tor出口ノードの識別、不正利用ネットワークのスコアリングを1回のJSONレスポンスで取得できます。登録は不要です。

いいえ。無料プランではキーもサインアップも不要です。エンドポイントを直接呼び出すだけです(制限はIPアドレスごとに管理されます)。ProまたはEnterpriseの上限を使うには、X-API-Keyヘッダーまたは?api_key=でキーを送信してください。無料キーはPOST /v1/keysですぐに発行できます。

https://ipto.toです。すべてのエンドポイントは/v1/配下にあります。すべてのエンドポイントでCORSが有効になっています。

GET https://ipto.to/v1/ip — パラメータは不要です。IPアドレスとともに、都市、州/地域、タイムゾーン、緯度経度が返されます。またはターミナルでcurl ipto.toを実行してください。

はい。curl ipto.toはcurlのUser-Agentを自動検出し、あなた自身のIPについて、国、都市、ASN、ライブの天気などのフィールドを含むコンパクトなJSONを返します。curl ipto.to/8.8.8.8とすれば、任意のIPについて同様の結果が得られます(天気情報は含まれません)。WgetやHTTPieでも動作します。

IPジオロケーションは、IPレンジをエンドユーザーではなくネットワークインフラの物理的な所在地にマッピングするものです。ISPは、数百マイル離れた地域の交換ポイントを経由してトラフィックをルーティングすることがあります。国レベルの精度は高いですが、住宅用やモバイルのIPでは都市レベルの精度が低下します。

VPNに接続すると、あなたのトラフィックはVPNサーバーのIPアドレスから出ていきます。iptoは、あなたの実際の所在地ではなく、その出口サーバーの位置を報告します。この場合、is_vpnフラグはtrueになります。

データの品質は、ISPや組織がWHOISやルートレジストリにIPブロックをどれだけ正確に登録しているかに左右されます。大手クラウドプロバイダーやISPの記録は非常に正確です。規模の小さい、あるいは古い割り当てでは、精度が低いことがあります。

はい。IPv6アドレスでは、ASN・組織・IP範囲に加え、範囲がカバーされていればMaxMindデータセットによる市区町村レベルの位置情報(市区町村、地域、郵便番号、緯度経度)を返し、ボゴン/プライベート範囲も識別します。唯一の制約は、VPN・Tor・不正利用フラグが現時点ではIPv4のみという点です。これらのフィードはIPv4範囲として提供されているため、IPv6アドレスでは推測せずfalseを返します。

Bogon(偽)IPとは、パブリックインターネット上で送信元として現れるべきではないアドレスの総称です。ループバック(127.x.x.x)、RFC 1918のプライベートレンジ(10.x、172.16–31.x、192.168.x)、リンクローカル(169.254.x)、マルチキャスト(224–239.x)、IANA予約ブロックなどが含まれます。iptoはデータベース検索を行う前にこれらを検出し、該当する場合はbogon: trueと理由を示すbogon_typeを返します。任意のアドレスをBogon IPチェッカーで確認できます。

iptoは、BGPルーティング分析とアクティブな列挙によって構築された、既知のVPNサーバーIPレンジのデータベースを維持しています。検索時には各IPがこのデータベースと照合されます。プロバイダーの特定はASNの所有者情報から行われます。ASNがVPN事業者専用に登録されている場合、そのプロバイダー名が識別されます。任意のIPをVPN & プロキシチェッカーでテストできます。

Tor出口ノードのリストは、check.torproject.orgで公開されているTor Project公式の一括出口ノードリストから取得しています。これは、現在Tor出口トラフィックを発信できるIPの公式リストです。6時間ごとに更新されます。

そのIPが、スパム発信元、マルウェアのコマンド&コントロールサーバー、ボットネットのリレー、大規模な攻撃ツールなど、不正なインフラをホストしているとして複数の独立した脅威インテリジェンスフィードによってフラグ付けされたネットワークレンジに属していることを意味します。不正利用スコアが高いほど、独立して同意しているフィードの数が多いことを示します。

is_datacenterは、そのIPがホスティングプロバイダー、クラウドプラットフォーム、またはCDNに属していることを意味します。is_residentialは、そのIPが個人向けのブロードバンド回線として分類されていることを意味します。実際にはどちらでもないIPが大半です — ホスティングでも住宅用でもないISPインフラに属しているケースです。

VPNやTorには分類されない、既知のプロキシ出口ポイントを示すフラグです。現在は脅威フィードパイプラインからのデータに限定されており、VPNやTorの検出に比べてカバレッジは低くなっています。

自律システム番号(ASN)は、インターネット上で独自にIPルーティングポリシーを管理するネットワークを一意に識別する番号です。例えば、GoogleはAS15169、AmazonはAS16509です。すべてのIPブロックは、必ずいずれか1つのASNによってアナウンスされます。任意のASNをASN検索ツールで直接調べられます。

ASNを運用する組織のカテゴリーを示します。値は次の通りです: hosting(クラウドまたはサーバーホスティング)、isp(インターネットサービスプロバイダー)、business(企業ネットワーク)、education(大学・研究機関)、government(政府機関)、mobile(通信キャリア)、residential(住宅用)。

そのIPブロックが携帯キャリアに登録されていることを意味します。モバイルIPはユーザー間で頻繁に再割り当てされ、キャリアの本社とは異なる地理的位置に表示されることがよくあります。

はい — GET /v1/asn/:asn/ranges?limit=&offset=は、実際の範囲(それぞれ国コードとhosting/mobile/residential/bot/blacklistフラグ付き)を1リクエストあたり最大200件までページネーションして返します。メインのGET /v1/asn/:asnルックアップにもip_range_countとrank(範囲数に基づく、その国内でのASNの規模順位)が含まれており、rangesエンドポイントを使わなくても確認できます。ASN検索ツールをご覧ください。

GET /v1/asn/:asn/whoisは、RDAP経由でRIRの登録情報(名称、ステータス、国、登録日/最終変更日、連絡先)を返します。GET /v1/asn/:asn/relationshipsは、CAIDAのAS-Relationshipsデータセットに基づく既知のピア、上流プロバイダー、下流カスタマーを返し、GET /v1/asn/:asn/relatedは同じ組織が運用している可能性が高い他のASNを見つけます。この3つはASN検索ページでまとめて表示されます。

あります — All IP Ranges(GET /v1/ip-ranges)は、256個すべての/8ブロックを閲覧できるディレクトリで、/16まで掘り下げた上で、実際に割り当てられている範囲とそれぞれが属するASNを確認できます。

無料プランでは、IPアドレスごとに1日1,000リクエストまで、登録もキーも不要で利用できます。Proキーでは1日100,000リクエストまで、Enterpriseでは無制限です。上限を超えるとHTTP 429が返されます。詳しくは料金ページをご覧ください。

IP文字列のJSON配列を/v1/ip/bulkにPOSTしてください — 1リクエストあたり最大100件まで対応しており、Pro/Enterpriseプラン限定です(料金ページ参照)。レスポンスはIPをキーとするオブジェクトです。並列キャッシュ読み取りにより、逐次呼び出しよりも高速です。各IPは、個別検索と同様に1日あたりの利用上限にカウントされます。

任意の単一IPリクエストに?fields=field1,field2を追加してください。例: /v1/ip/1.1.1.1?fields=ip,country_code,is_vpn,is_tor。ipフィールドは常に含まれます。

JSON(デフォルト)、CSV、プレーンテキスト、XML、YAMLに対応しています。任意の単一IPリクエストに?format=csv、?format=text、?format=xml、?format=yamlのいずれかを追加してください。CSVとテキストはフラットなキー/バリューのペアを返し、XMLとYAMLはflagsのようなネストされたオブジェクトをそのまま保持します。

公式のSDKはまだありません。このAPIは標準的なHTTP JSONエンドポイントであり、任意のHTTPクライアントで利用できます。curl、JavaScript、Python、PHP、Goのサンプルについてはドキュメントをご覧ください。

はい。https://ipto.to/mcpはModel Context Protocol(MCP)サーバーで、同じ照会機能をJSON-RPC経由の呼び出し可能なツールとして公開しています。IP(単体・一括)、ASN(範囲/whois/関係)、IP whois、RPKI、企業、キャリア、ホストされているドメイン、統合検索、近くの場所、国、逆引きDNS、ユーザーエージェント、電話、メール、不正スコア、言語、通貨、天気、商標、特許に対応し、MCP対応クライアントは生のHTTPリクエストを組み立てずに直接呼び出せます。REST APIと同じX-API-Keyとレート制限ルールが適用されます。

ASN/IPレンジのデータセットは毎日UTC 04:00に更新されます。都市レベルのジオロケーションは2つの独立したソースをそれぞれのスケジュールで統合しています(IP2Locationは毎月、MaxMindは毎週)。そのため、ASNの更新の合間にも精度が向上することがあります。脅威フィード(VPN、Tor、不正利用)は6時間ごとに同期されます。エッジキャッシュのTTLは5分です。

複数の主要な業界データプロバイダーから情報を収集しており、毎日更新しています。VPN検出にはBGPから得られるレンジ情報を使用しています。Torノードのデータは、公式のTor Projectレジストリと検証済みリレーリストから取得しています。不正利用ネットワークについては、複数ソースを相互に裏付け合ったブラックリスト情報を使用しています。

VPNおよびTorの検出は、主要プロバイダーとすべての確認済み出口ノードに対して高い再現率を持っています。汎用のホスティングASNからIP空間を借りている、規模の小さい、あるいは新しいVPNサービスについては、プロバイダー名までは特定できないことがあります。不正利用スコアは複数フィードによる裏付けを用いており、Mediumティアに分類されるには3件以上、Criticalには8件以上の独立したソースが必要です。

abuse_scoreは、いくつの独立した脅威ソースが同一ネットワークにフラグを立てているかという複数フィードの裏付けに基づく1–10の深刻度スコアです。threat_typeは、どのカテゴリーがフラグの原因となったかを示します — tor_exit、vpn、abuserのいずれかです。risk_tierは、スコアをcritical(8–10)、high(5–7)、medium(3–4)に分類します。IP不正利用チェッカーでライブチェックを試してみてください。

はい。国が解決されたレスポンスには、いずれもcurrency_codeとexchange_rate_usdが含まれます — 世界154通貨をカバーする日次参考レートです。このリストに含まれない通貨については、レートはnullとして返されます。

国のデータを含む各レスポンスには、languages(公用語)、tld(国別コードトップレベルドメイン)、capital(首都)、borders(隣接国のISOコード)が含まれます — 追加のAPI呼び出しなしに、コンテンツのローカライズや国別対応のフォーム作成に活用できます。

GET /v1/ip/:ip/hostnameは、DNS-over-HTTPSによるライブPTR検索を行い、{ ip, hostname }を返します。これはキャッシュされたドメイン列挙データベースではなく、その都度のオンデマンド検索です — PTRレコードが存在しない場合、hostnameはnullになります。ブラウザ用ツールも/reverse-dns-lookupで利用できます。

はい。GET /v1/datasets/:kindは、asn、ranges、geo-cityのCSVエクスポートを返します — これらはAPIが内部で参照しているのと同じデータセットで、同じスケジュールで更新されます。geo-cityは、任意で?source=primary(デフォルト)または?source=secondaryを指定できます。都市レベルのデータは、カバレッジの異なる2つの独立したソースを統合したものだからです。

Proキーでは、1日100,000リクエストの上限と一括検索(POST /v1/ip/bulk、1リクエストあたり最大100件のIP)が利用可能になります — 一括検索は無料プランではまったく利用できません。Enterprise(リクエスト無制限)では、さらにカスタムSLAと専任サポートが追加されます。都市/郵便番号/緯度経度の精度は、無料プランを含むすべてのプランに含まれています。POST /v1/keysで無料プランのキー(1日1,000リクエスト、GET /v1/keys/usage?key=Xによる利用状況の追跡が可能)を発行できます — アップグレードについては料金ページをご覧ください。

geo_precisionが許す限り、どちらでも利用できます。あなた自身のIP(GET /v1/ip)は、接続先のエッジネットワークから常に都市レベルのデータが取得されます。明示的なIP検索(GET /v1/ip/:ip)では、そのIPが都市レベルデータセットのカバレッジ内にある場合に都市レベルのデータが取得されます。それ以外の場合、geo_precisionはcountryとなり、city/state/lat/lonはnullを返します。

Add ?lang= to any request with one of: pt, fr, de, zh-TW, ko, zh-CN, ja-JP, es-ES, ar-SA, hi-IN (en is the default). This localizes country_name and continent into the target language. Field names and threat data stay in English regardless of locale.

はい — GET /v1/email/:emailは、構文チェック、ライブのMXレコード検索、そして同期されたブロックリストに基づく使い捨て/一時的なドメインの検出を行います。無料で登録も不要です。メールチェッカーをお試しください。

はい — GET /v1/phone/:numberは、E.164形式または各国内形式の番号を解析し、有効性、国、地域、回線種別(携帯、固定、またはVoIP)を、同期されたMCC/MNCキャリアデータセットと照合して判定します。電話番号チェッカーをお試しください。

GET /v1/fraud-scoreは、IPの脅威シグナル、メール配信可否、電話番号の有効性、User-Agentによるボット検出を統合し、0–100の1つのリスクスコアにまとめます — これは主要な単体IPインテリジェンスAPIのいずれも提供していない機能です。4つの入力はすべて任意で、渡さなかったシグナルは単に「なし」として扱われ、クリーンとしてスコアリングされることはありません。不正スコアチェッカーをお試しください。

はい — GET /v1/languageは、ローカルでのトライグラム頻度分析により、76言語の中から任意のテキストの言語を識別します。テキストが第三者のベンダーやAIモデルに送信されることはなく、ログも一切残りません。言語検出ツールをお試しください。

はい — GET /v1/currency/convertとGET /v1/currency/ratesは、すべてのIP/国検索におけるexchange_rate_usdを支えているのと同じ日次為替レートフィードを、154通貨に対応する形で公開しています。さらにGET /v1/currency/historyでは90日分の履歴レートを取得できます。通貨換算ツールをお試しください。

はい — GET /v1/weatherは、任意の地名、郵便番号、または座標のペアについて現在の天候を返します。&detail=1を追加すると、1時間ごとの見通しと3日間予報も取得できます。ホームページの自分のIP向け天気ウィジェットと天気検索ツールの両方でこれを使用しています。

はい — GET /v1/trademark/:serialは、8桁のシリアル番号によるライブの審査状況について、USPTOのTSDR APIをプロキシしています。審査状況のテキストは米国政府の著作物でありパブリックドメインであるため、すべてのレスポンスにsource/attributionフィールドが含まれます。商標のロゴ/画像データは意図的に対象外としています。登録番号による検索には対応していません — 現時点でUSPTOが公開しているのはシリアル番号によるパスのみです。商標検索ツールをお試しください。

はい — GET /v1/patent/:numberは、7–8桁の実用特許番号による登録状況について、USPTOのライブなPatent File Wrapper APIをプロキシしています。カバレッジは2001年以降に出願された案件からで、データは審査・書誌情報(出願日、ステータス、発明者、代理人)が中心です — Lens.org、Espacenet、Google Patentsのような引用グラフ、パテントファミリー、法的ステータスのフィールドは提供していません。意匠特許、植物特許、再発行特許にはまだ対応していません。特許検索ツールをお試しください。

単一のリクエストです — GET /v1/search/:query。入力されたのがIP、ASN、国コード、メールアドレス、電話番号のいずれであるかを検出し、サーバー側で関連するすべてのチェック(IP検索、RPKI、企業情報、whois、キャリア、ホスト済みドメイン、周辺スポット)を並列に実行します。1回の検索は、機能ごとにではなく、1日あたりのレート制限予算に対して1リクエストとしてのみカウントされます。

はい — GET /v1/ip/:ip/rpki(および明示的なGET /v1/rpki?asn=&prefix=形式)は、5つすべてのRIRからROAデータを集約するRIPEstat経由で、経路オリジン検証をライブに解決します。ステータスはvalid、invalid、unknownのいずれかのみで、他のシグナルから推測されることはありません。RPKI検証ツールをお試しください。

GET /v1/ip/:ip/companyは、RDAPの登録者データとIP自身のASN組織名を組み合わせ、1つのカテゴリー的な信頼度(high/medium/low/none)として「誰が所有しているか」を判定します。GET /v1/ip/:ip/whoisは、その基盤となるRDAPレコード自体を返します。ネットワークブロック、割り当て種別、登録日、そして登録されているすべての登録者/管理者/不正利用の連絡先など、従来のWHOIS出力に近い内容です。IPから企業情報またはIP Whoisをお試しください。

ベストエフォートであり、既にモバイルネットワークとして分類されているIPに限られます。GET /v1/ip/:ip/carrierは、ASNの組織名を、そのIPの国に絞ったMCC/MNC事業者ディレクトリとあいまい一致させます。単一のcarrier: "X"フィールドは意図的に用意していません — 名前を単独で示すと、データが正直に裏付けられないリアルタイムな契約者ごとの主張のように読めてしまうためです。IPから携帯キャリアツールをお試しください。

GET /v1/ip/:ip/hosted-domainsは、そのIPの逆引きDNSホスト名と証明書透明性(Certificate Transparency)ログ(crt.sh)からドメインを見つけます — これは一般的な逆引きIP検索ではありません。レスポンス自身のlimitationsフィールドには、構造上見つけられない範囲(PTRレコードのないIP、共有ホスティング上の無関係なドメイン、CTログに一度も記録されていないドメイン)が明記されています。ホスト済みドメインをお試しください。

GET /v1/places/:ipは、IPの既存の都市レベルの位置を逆ジオコーディングした上で、周辺の関心地点(レストラン、公園、学校、交通機関)、有名なランドマーク、データソースが存在する場合の地域の犯罪データ(英国・米国のみ)、そして目的地を指定した場合のオンデマンドの車移動時間の見積もりを返します。周辺スポットをお試しください。

GET /v1/ip/:ipのconnection_typeは、flagsオブジェクトと同じASN分類から導かれる、単一のベストエフォートなラベルです — mobile、datacenter、またはunknownのいずれかです。これは、Cloudflare Workerでは観測できない(生のTCP/IPパケットへのアクセスがない)デバイス数やNATベースの接続検出の代わりとなるものです — そのため偽装するのではなく、分類できないASNについては正直にunknownを返します。

はい、常に無料のローカルチェックの上位にあるプレミアム層として利用できます。GET /v1/phone/:numberは引き続き最初に無料のローカル検証(フォーマット、地域、回線種別 — 変更なし、前の質問を参照)を実行し、予算に余裕があれば、リアルタイムキャリア照会プロバイダーから、ライブのcarrier、original_carrier、is_ported、phone_type分類、および地域レベルのphone_regionとcountry_prefixを追加します。完全な国名を表すcountry_nameは階層に関係なく常に含まれ、他のすべてのエンドポイントのcountry_nameフィールドとまったく同じように?lang=/Accept-Languageによってローカライズされます — 実際に適用された言語を確認するには、レスポンスのlang/lang_sourceを参照してください。レスポンスのsourceフィールドは、どちらの階層が応答したかを示します: "premium"または"local"。

Freeプランでは月100回/IPアドレスのプレミアム照会、Proでは月1,000回/APIキー、Enterpriseでは月5,000回です — 料金を参照してください。これは既存の無料ローカル電話照会の予算(Freeで100/日)に追加されるもので、こちらには独自の月間上限はありません。

何も壊れません。GET /v1/phone/:numberは月の残り期間、無料のローカルエンジンにシームレスにフォールバックします — フォーマット、地域、回線種別のデータを含む完全な200レスポンスは引き続き得られますが、ライブのcarrier/is_portedフィールドだけが(その場合nullとsource: "local"を返します)なくなります。エラーは発生せず、無料プランを使い続けるための登録も不要です。

これらは2つの異なるエンジンから得られる独立した分類であり、意図的に統合せず分離しています。line_typeは常に無料のローカルチェックから得られます(このチェック独自のenum、例: MOBILE、FIXED_LINE、PREMIUM_RATE)。phone_typeはsourceが"premium"の場合のみ表示され、キャリア照会プロバイダー独自のカテゴリーを使用します: mobile、fixed_line、voip、toll_free、premium_rate、shared_cost、personal_number、pager、uan、voicemail、またはunknownです。不正利用の兆候としてこのAPIを利用している場合は、特にpremium_rateに注意してください — プレミアムレート番号(通常の回線より高い分単位料金が請求される番号)は、国際プレミアムレート詐欺(IRSF)でよく使われる手口であり、このエンドポイントはVoIPのフラグ付けだけでなく、その分類を直接提示します。

プレミアム照会が実際に実行される場合のみです(つまり前の質問の月間予算が使い切られていない場合)— 無料のローカルチェックは、ipto.to自身のCloudflare Workersから外に出ることは決してありません。プレミアム照会が実行される場合、その番号は1件のリクエストに応答するためだけに、当社のキャリア照会プロバイダーに送信されます。プロバイダーのAPIキーは公開アクセス可能な場所には一切保存されず、ipto.toの標準ログポリシー(概要を参照)に従い、当社自身もクエリ履歴を記録しません。

毎日00:00 UTCにリセットされます。上限を超えたリクエストにはHTTP 429が返され、Retry-Afterヘッダーとretry_after_secondsフィールドでリセットまでの正確な秒数が示されます。

POST /v1/keysを呼び出すと無料プランのキーがすぐに発行されます。またはサインインしてください。サインインすると無料プランのアカウントが自動作成され、ダッシュボードにキーと使用状況が表示されます。ProとEnterpriseへは料金ページからアップグレードできます。

X-API-Keyヘッダー(クエリ文字列はログに残る可能性があるため推奨)、またはURLの?api_key=で送信します。キー付きのリクエストは、IPではなくそのキーの上限に対してカウントされます。キーの使用状況はGET /v1/keys/usage?key=Xで確認できます。

ほぼその通りです。検索バーでの検索やMCPツール呼び出しは、サーバー側で複数のチェックに展開されても1リクエストです。一括呼び出しは項目ごとに課金され、POST /v1/ip/bulk内の各IPや一括電話照会の各番号が個別にカウントされます。近くの場所検索とプレミアム電話照会には、一般の上限とは別に専用の枠があります。

いいえ。iptoは照会されたIPアドレスを記録せず、クエリ履歴の保存やプロファイリングも行いません。キャパシティ計画のために集計済みのリクエスト数のみを保持します。ホームページの検索履歴やスター付きの照会はお使いのブラウザ内にのみ保存されます。詳細はプライバシーページをご覧ください。

はい。APIはCORS対応で、/v1/以下でバージョン管理され、安定したJSONを返します。無料プランは個人利用や軽い利用向け(1日1,000リクエスト)です。本番トラフィックにはPro(1日100,000)またはEnterprise(無制限、カスタムSLA付き)をご利用ください。料金と、稼働状況を確認できるステータスページもご覧ください。