DNS・ネットワーク 1 エンドポイント 8 主な機能

IP ジオロケーション API

プライマリプロバイダーのデータとDomScanの補足シグナルを使い、公開IPアドレスのネットワーク情報を確認できます。位置情報は概算です。PTR、FCrDNS、クラウドIPレンジによる補足は主にIPv4を対象とします。

カテゴリ DNS・ネットワーク
エンドポイント 1
主な機能 8
よくある質問 4

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

ライブ サービスステータス

統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。

OpenAPI API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

10,000 無料枠

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

この API で実装できること

このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。

プロダクトワークフロー

ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。

アナリスト自動化

繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。

クリーンな JSON データ

提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。

AI と運用ツール

OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。

統合ワークフロー

最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。

1
一度認証する

文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。

2
例から問い合わせる

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

3
運用と監視

ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。

開発者キット

機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。

パラメータとレスポンスのマップ

クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。

リクエストパラメータ

パラメータ

ip
レスポンスフィールド

レスポンス例

ipdomaingeolocationgeolocation.countrygeolocation.country_namegeolocation.regiongeolocation.region_namegeolocation.citygeolocation.postalgeolocation.latitudegeolocation.longitudegeolocation.timezone
ステータス範囲

HTTP ステータスコード

200400401402429500502503504

エンドポイント

GET /v1/ip
クレジット: 1認証: 認証が必要です
ip

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

サービスステータス API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

無料枠 無料でサインアップ

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

アクティブ リクエスト例

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

主な機能

位置情報

データ提供元が推定した都市、地域、国、郵便番号、座標を、利用できる範囲で表示します。

ISP情報

データ提供元がIPアドレスに関連付けたISPを表示します。

組織情報

IPアドレスまたはネットワークに関連付けられた組織を表示します。所有権を証明する情報ではありません。

ASN情報

ルーティングの所属を確認するためのASNとネットワーク運用者情報です。

ホスティングのシグナル

プロバイダーのホスティングフラグを使います。IPv4では既知のクラウドIPレンジとPTRパターンも参考にします。

限定的なセキュリティシグナル

プロバイダーのプロキシフラグ、整理されたTor出口ノードのリスト、VPN利用の可能性があるASNの大まかな手がかりを表示します。

タイムゾーン情報

推定されたIPアドレスの位置にデータ提供元が関連付けたタイムゾーンです。

リバースDNS

IPv4のPTRとFCrDNSを、利用できる場合に確認します。リクエストに含めたドメインはPTRの分類に使いません。

リクエスト例

GET /v1/ip bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"

レスポンス例

200 OK json
{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": null,
    "region_name": null,
    "city": null,
    "postal": null,
    "latitude": null,
    "longitude": null,
    "timezone": null,
    "precision": "country"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": "Google LLC",
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "intelligence_summary": {
    "query_type": "ip",
    "domain_resolved": false,
    "cache_status": "miss",
    "data_source": "cloudflare-intel+enrichment",
    "confidence": "high",
    "confidence_score": 100,
    "asn_present": true,
    "organization_present": true,
    "country_present": true,
    "security_signal_count": 2,
    "risk_flags": [
      "cloud",
      "datacenter"
    ],
    "hosting_category": "cloud"
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "cloudflare-intel+enrichment"
  }
}

よくある質問

位置情報はどの程度正確ですか?

位置情報はプライマリプロバイダーが提供する概算値です。IPアドレス、ネットワーク、地域によって精度は異なります。正確な現在地や本人確認には使えません。

IPv6アドレスを検索できますか?

プライマリプロバイダーから、IPv6の基本的な位置情報とネットワーク情報を取得できる場合があります。PTR、FCrDNS、クラウドIPレンジによる追加確認はIPv4が中心のため、IPv6の応答はより限定的です。

プロキシはどのように判定しますか?

DomScanは、プライマリプロバイダーのプロキシフラグに、整理されたTor出口ノードのリストと、VPN利用の可能性があるASNの大まかな手がかりを組み合わせます。行動分析は行わず、すべてのVPNやプロキシを検出できるわけではありません。

データはリアルタイムですか?

いいえ。プライマリプロバイダーのデータとDomScanの補足データは、最長24時間キャッシュされることがあります。各データソースの変更がいつ反映されるかは保証していません。

関連ツール&リソース

HTTP ステータスコード

正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

APIキーまたはセッションが不足しているか無効です。

支払いが必要 402

このリクエストを実行するためのクレジットが不足しています。

リクエスト過多 429

レート制限を超過

サーバーエラー 500

内部エラー

不正なゲートウェイ 502

上流 RDAP エラー

サービス利用不可 503

上流サービスが利用できないか、一時的にレート制限しています。

ゲートウェイタイムアウト 504

上流の問い合わせがタイムアウトしました。

IPアドレスを検索