ウェブインテリジェンス 2 エンドポイント 6 主な機能

統合URLインテリジェンスAPI

公開URLを送信すると、正規化されたページメタデータ、プレビュー素材、リダイレクトの根拠、構造化データの種類、セキュリティヘッダー、公開アイデンティティのシグナルを1つのレスポンスで返します。

カテゴリ ウェブインテリジェンス
エンドポイント 2
主な機能 6
よくある質問 5

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

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に 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、エージェント用ツールへすぐ移動できます。

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

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

リクエストパラメータ

パラメータ

url
レスポンスフィールド

レスポンス例

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached
ステータス範囲

HTTP ステータスコード

200400401402429500502503504

エンドポイント

GET /v1/url-intelligence
クレジット: 2認証: 認証が必要です
POST /v1/url-intelligence/bulk
クレジット: 2認証: 認証が必要です

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

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

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

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

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

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

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

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

アクティブ リクエスト例

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

主な機能

正規化されたページメタデータ

タイトル、説明、言語、コンテンツタイプ、最終URL、正規URLを抽出します。

リンクプレビュー項目

正規化された画像、ファビコン、Open Graphタグ、Twitter Cardsからプレビューカードを構築できます。

構造化データの概要

無制限のページデータを返さず、JSON-LDの種類を特定し、不正なブロックを報告します。

robotsとセキュリティのシグナル

インデックス登録可否の指示と、許可リストに含まれる公開セキュリティヘッダーを読み取ります。

連絡先と公開プロフィール

明示されたメール、電話番号、ソーシャル、開発者、クリエイターのリンクを抽出します。

URLメタデータの一括取得

制限された並行処理と項目別エラーにより、1回のリクエストで最大10件のURLを調査します。

リクエスト例

GET /v1/url-intelligence?url=https://example.com bash
curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence
POST /v1/url-intelligence/bulk bash
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

レスポンス例

200 OK json
{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

よくある質問

URLメタデータAPIとOpen Graph APIの違いは何ですか?

Open Graph APIはソーシャルタグを中心に扱います。DomScanはさらに、正規URL、リダイレクト、robots、構造化データ、セキュリティ、連絡先、アイデンティティのシグナルを返します。

Open Graphタグがない場合はどうなりますか?

Open Graph項目は空のままですが、標準のタイトル、説明、アイコン、構造化データなど、利用可能なシグナルは引き続き返されます。

APIはJavaScriptを実行しますか?

いいえ。初期バージョンはサイズを制限した公開HTMLレスポンスを調査し、クライアント側JavaScriptの実行後にだけ現れるメタデータがあるとは主張しません。

APIはリダイレクトを安全にたどりますか?

はい。リダイレクト回数を制限し、各転送先を検査して、プライベートまたは内部ネットワークの対象へのアクセスを防ぎます。

複数のURLを一度に調査できますか?

はい。一括エンドポイントは最大10件の公開URLを受け付け、入力順を維持します。

関連ツール&リソース

HTTP ステータスコード

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

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

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

支払いが必要 402

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

リクエスト過多 429

レート制限を超過

サーバーエラー 500

内部エラー

不正なゲートウェイ 502

上流 RDAP エラー

サービス利用不可 503

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

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

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

URLインテリジェンスで開発する