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

企業ロゴとウェブサイト・アイデンティティ素材API

ドメインを送信すると、公開ウェブサイトから見つかった、出典が明確なアイデンティティ素材を返します。各候補には検出元が含まれ、見つからない素材は null のままです。

カテゴリ ウェブインテリジェンス
エンドポイント 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、エージェント用ツールへすぐ移動できます。

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

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

リクエストパラメータ

パラメータ

domain
レスポンスフィールド

レスポンス例

domainorganization_nameassetsassets.logo_urlassets.favicon_urlassets.theme_colorassets.candidatesconfidenceevidence
ステータス範囲

HTTP ステータスコード

200400401402429500502503504

エンドポイント

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

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

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

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

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

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

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

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

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

アクティブ リクエスト例

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

主な機能

出典に基づくロゴ検出

構造化データや公開ウェブサイトのメタデータで明示されたロゴ候補を見つけます。

ファビコンとアプリアイコン

ファビコン、Apple touch icon、マスクアイコン、ウェブマニフェストへの参照を抽出します。

プレビュー画像とテーマ素材

アイデンティティ素材とともに、Open Graphのプレビュー画像と明示されたテーマカラーを返します。

素材の出典情報

各候補について、出典、素材の種類、MIMEタイプ、利用できる場合は明示されたサイズを示します。

明示されたソーシャルプロフィール

ウェブサイトからリンクされた公開プロフィールを正規化し、出典と信頼度を添えて返します。

ブランド素材の一括検索

1回のリクエストで最大10件のドメインを、入力順の結果と項目別エラー付きで処理します。

リクエスト例

GET /v1/identity-assets?domain=example.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com"
POST /v1/identity-assets/bulk bash
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

レスポンス例

200 OK json
{
  "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は企業ロゴをどのように選びますか?

DomScanはOrganization構造化データで明示されたロゴを優先し、その他のウェブサイトアイコンやプレビュー画像は別の候補として扱います。

ロゴとファビコンの違いは何ですか?

ロゴは組織を表し、ファビコンはウェブサイト用の小さなアイコンです。APIは両者を分けて返すため、アプリケーションに適した素材を選べます。

APIは返す画像をホストまたは変換しますか?

いいえ。APIは元の公開素材URLとその出典情報を返します。許可された利用、キャッシュ、表示は利用者のアプリケーション側で管理してください。

ウェブサイトに使用可能なロゴがない場合はどうなりますか?

logo項目は null のままです。明示された他のアイコンやプレビュー画像は、ロゴと誤表示せず別の候補として返せます。

企業ロゴを一括取得できますか?

はい。一括エンドポイントに最大10件のドメインを送信できます。結果は入力順を維持し、個別の失敗が成功した項目を隠すことはありません。

関連ツール&リソース

HTTP ステータスコード

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

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

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

支払いが必要 402

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

リクエスト過多 429

レート制限を超過

サーバーエラー 500

内部エラー

不正なゲートウェイ 502

上流 RDAP エラー

サービス利用不可 503

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

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

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

ウェブサイトのアイデンティティデータで開発する