統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
この API で実装できること
このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。
ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。
繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。
提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。
OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。
統合ワークフロー
最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。
文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。
開発者キット
機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。
パラメータとレスポンスのマップ
クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。
パラメータ
レスポンス例
HTTP ステータスコード
エンドポイント
/v1/identity-assets
/v1/identity-assets/bulk
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
主な機能
構造化データや公開ウェブサイトのメタデータで明示されたロゴ候補を見つけます。
ファビコン、Apple touch icon、マスクアイコン、ウェブマニフェストへの参照を抽出します。
アイデンティティ素材とともに、Open Graphのプレビュー画像と明示されたテーマカラーを返します。
各候補について、出典、素材の種類、MIMEタイプ、利用できる場合は明示されたサイズを示します。
ウェブサイトからリンクされた公開プロフィールを正規化し、出典と信頼度を添えて返します。
1回のリクエストで最大10件のドメインを、入力順の結果と項目別エラー付きで処理します。
リクエスト例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com"
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
-d '{"domains":["example.com","github.com"]}' https://domscan.net/v1/identity-assets/bulk
レスポンス例
{
"domain": "example.com",
"organization_name": "Example",
"assets": {
"logo_url": "https://example.com/logo.svg",
"favicon_url": "https://example.com/favicon.ico",
"theme_color": "#111827",
"candidates": []
},
"confidence": 0.8,
"evidence": ["organization_name", "structured_logo", "declared_icon"]
}
よくある質問
DomScanはOrganization構造化データで明示されたロゴを優先し、その他のウェブサイトアイコンやプレビュー画像は別の候補として扱います。
ロゴは組織を表し、ファビコンはウェブサイト用の小さなアイコンです。APIは両者を分けて返すため、アプリケーションに適した素材を選べます。
いいえ。APIは元の公開素材URLとその出典情報を返します。許可された利用、キャッシュ、表示は利用者のアプリケーション側で管理してください。
logo項目は null のままです。明示された他のアイコンやプレビュー画像は、ロゴと誤表示せず別の候補として返せます。
はい。一括エンドポイントに最大10件のドメインを送信できます。結果は入力順を維持し、個別の失敗が成功した項目を隠すことはありません。
関連ツール&リソース
HTTP ステータスコード
正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。
リクエスト成功
無効なパラメータ
APIキーまたはセッションが不足しているか無効です。
このリクエストを実行するためのクレジットが不足しています。
レート制限を超過
内部エラー
上流 RDAP エラー
上流サービスが利用できないか、一時的にレート制限しています。
上流の問い合わせがタイムアウトしました。
ウェブサイトのアイデンティティデータで開発する