リクエストの実行

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

必須。分類するIPv4アドレス。リクエストURLのパスセグメントとして指定します。例：/api/v1/ip/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の浮動小数点数。分類結果について補正された信頼度。値が高いほど、より強い根拠があることを示します。

文字列。レコードの生成に使用された検出方法（例：mslm、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レベルの不正利用スコア。すべてのプランで利用できます。プレミアムプラン（Growth以上）では、詳細な内訳も確認できます。

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

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

flagged_ratio：0.0～1.0の浮動小数点数。ASN内でフラグが付けられたIPアドレスの割合（Growth以上のプランで利用可能）。

flagged_ip_count：整数。フラグが付けられたIPアドレスの数（Growth以上のプランで利用可能）。

total_announced_ips： 整数。このASNがアナウンスしているIPアドレスの総数（Growth以上のプランで利用可能）。

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

raw_score：数値。内部で使用される信頼度スコア（0～100）。

signals：オブジェクト。検出シグナル（ポートパターン、プロトコルなど）。

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

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

オブジェクトまたはnull。地理情報。プレミアムプラン（Growth以上）でのみ利用可能。観測された位置情報を利用できない場合は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。観測に関するメタデータ。

2リクエスト/分

30リクエスト/分

100リクエスト/分

250リクエスト/分

500リクエスト/分

カスタム：お問い合わせください。