リクエストの実行

必須。「My products」ページで個人用APIキーを取得してください。

必須。分類対象のIPv4アドレス。例：/api/v1?apiKey=YOUR_API_KEY&ipAddress=185.220.101.1。

照会したIPv4アドレス。そのまま返されます。

文字列またはnull。IPアドレスが属するCIDR範囲（判明している場合）。

文字列。IPアドレスの検出タイプ。

指定可能な値：vpn、corporate_vpn、proxy、hosting、cdn、tor、relay、residential_proxy、residential_proxy_likely、residential_proxy_mobile、datacenter_proxy、mobile_proxy、suspected_vpn、suspected_proxy、unknown。

文字列またはnull。IPアドレスに関連付けられたプロバイダー（例：VPNブランド、住宅用プロキシネットワーク、ホスティング事業者）。プロバイダーを特定できない場合はnull。

[0, 1] の範囲の浮動小数点数、または null。分類に対する確信度：値が大きいほど、証拠の強さが高いことを示す。Pro プランでは返されるが、Intro および Starter プランでは null となる。

文字列。そのレコードを生成した検知方法（例：partner_feed、port_scan、proxy_enum、netflow_analysis、asn_classification）。

文字列。sourceと同じ値（後方互換性のために残されている旧フィールド）。

文字列（ISO 8601形式）またはnull。IPアドレスが最初に観測された日時。

文字列（ISO 8601形式）またはnull。IPアドレスが最後に観測された日時。

整数。IPアドレスが観測された合計回数（ヒット数）。

浮動小数点数またはnull。継続性：直近90日間の観測期間のうち、IPアドレスがアクティブなプロキシ／VPNの出口として観測された日数の割合（観測された日数 ÷ 90 × 100）。

High (>50) indicates a consistently active exit; low (<5) indicates sporadic or one-shot activity. Null when the result comes from a network-range detection with no per-IP observation history.

整数。IPアドレスが出口として観測された、異なるプロキシ／VPNネットワークの数。2以上の場合、そのIPアドレスが複数の商用ネットワークで共有または再販されていることを示し、プロキシである可能性を強く示すシグナルとなります。0は、IPアドレス単位の列挙履歴がなく、IPアドレス範囲単位でのみ検出されていることを示します。

0～1.5の浮動小数点数。複数の根拠を組み合わせたエビデンス強度スコアで、鮮度係数 × 一貫性 × 複数プロバイダーによる加算で算出されます。1.0を超える値は、複数のプロバイダーで確認され、日次でアクティブなIPアドレスであることを示します。0.0 は、個別の観測ポイントでは一度も観測されていないことを示します。0～1に正規化したスコアを使用する場合は、min(confidence_decay, 1.0) を使用してください。

文字列。last_seen から算出された観測データの経過期間区分。日付を計算せずにフィルタリングできます。

指定可能な値：current（過去1日以内に観測）、recent（過去1週間以内）、stale（過去90日以内）、frozen（90日より前、または観測されたことがない）。

Boolean. True if the classification is in {vpn, vpn_concentrator, corporate_vpn, commercial_vpn, vpn_hosting} (confirmed VPN endpoints). Does not include tor, relay, suspected_vpn, or vpn_suspect — tor/relay have dedicated booleans; suspected_vpn/vpn_suspect are corroboration-only signals that do not set is_vpn. This asymmetry with is_proxy is deliberate: suspected_proxy does set is_proxy, but suspected_vpn/vpn_suspect never set is_vpn.

ブール値。classificationが {proxy,datacenter_proxy,mobile_proxy,suspected_proxy} のいずれかの場合はTrue。住宅用プロキシは含まれません（is_residential_proxy を参照）。種類を問わずすべてのプロキシを対象とするには、is_proxy または is_residential_proxy を使用してください。

ブール値。IPアドレスがTor出口ノード（classification tor）の場合はTrue。

ブール値。classificationがrelayの場合はTrue。Apple Private Relayなどのプライバシー保護を目的としたリレーサービスを示します。is_vpn とは異なり、リレーではユーザーが接続先を選択できず、プロバイダーが運用する出口を経由してユーザーのトラフィックがルーティングされます。

ブール値。IPアドレスがデータセンター／ホスティングプロバイダーに属する場合はTrue。

ブール値。IPアドレスがコンテンツ配信ネットワーク（CDN）に属する場合はTrue。

Boolean. True if the classification is in {residential_proxy, residential_proxy_likely, residential_proxy_mobile}. Mutually exclusive with is_proxy; use the more specific booleans below to filter further.

ブール値。residential_proxy（適合率85%以上）の場合はTrue 。is_residential_proxy のサブセットです。

ブール値。classification ==residential_proxy_mobileの場合はTrue。プロキシとして検出されたモバイル通信事業者のIPアドレスを示します。is_residential_proxy のサブセットです。

ブール値。IPアドレスが公開されているオープンプロキシのリストに掲載されている場合はTrue。is_proxyとは異なり、すべてのオープンプロキシはプロキシに該当しますが、大半のプロキシは公開リストには掲載されていません。

ブール値。IPアドレスがアプライアンス型VPN（Fortinet、Pulse Secure、Cisco AnyConnectなど）の場合はTrue。is_vpnのサブフラグです。

0～100の整数。confidence × 100 で算出され、高リスクの分類タイプの場合は10が加算されます。

整数またはnull。IPアドレスをアナウンスしている自律システム（AS）の番号。

文字列またはnull。ASNに登録されている組織名。

文字列またはnull。正規化されたCDN事業者のブランド名（小文字）。例：akamai、fastly、cloudflare、aws_cloudfront。classification ==cdn の場合のみnull以外の値になります。

オブジェクトまたはnull。ASNレベルの不正利用スコア。すべてのプランで利用可能。Pro以上のプランでは詳細な内訳を確認できます：

abuse_score：0～100の整数。このASNの不正利用レベル（すべてのプランで利用可能）。

abuse_level：文字列。low、moderate、high、criticalのいずれか（すべてのプランで利用可能）。

flagged_ratio— float 0.0–1.0、ASN 内のフラグが立てられた IP の割合（Pro 以上）。

flagged_ip_count— 整数。フラグが立てられたIPアドレスの数（Pro以上）。

total_announced_ips— 整数。このASNによってアナウンスされたIPアドレスの総数（Proプラン以上）。

オブジェクト。追加の検出シグナルおよびエンリッチメントデータ（すべてのキーは任意）：

raw_score— 予約済み；現在のすべてのプランで null です。

signals— 予約済み。現在のすべてのプランでnullとなっています。

dns_enrichment：オブジェクト。DNS PTRレコードおよび逆引きDNS（rDNS）の履歴。

tls_enrichment：オブジェクト。TLS証明書の分析情報。

オブジェクトまたはnull。地理データ（Enterprise版のみ）。観測位置データがない場合はnullとなる。キー：

exit_country：文字列またはnull。出口IPアドレスのISO 3166-1 alpha-2国コード。

user_countries：文字列の配列またはnull。このIPアドレスのユーザーが観測された国。

user_country_count：整整数またはnull。異なるユーザー所在国の数。

observed_lat/observed_lon：数値またはnull。観測された出口地点の座標。

observed_countries：文字列の配列。このコンセントレーターが観測された国。

observation_readings：文字列またはnull。観測に関するメタデータ。

120リクエスト/分

120リクエスト/分

150リクエスト/分

250リクエスト/分

500リクエスト/分

10,000リクエスト/分（すべてのエンタープライズキーで同じ一律の上限が適用されます）