アイデンティティと検証

ブランドデータAPI

1回のリクエストで企業のブランド情報をまとめて取得できます。ドメイン、株式ティッカー、ISIN、または企業名を送信すると、名称、説明、宣言されたソーシャルプロフィール、画像URLとしての正方形ロゴと横長ロゴ、そしてロゴ自体から読み取ったブランドカラーが返ります。各項目には情報源と確認日時が付きます。

カテゴリ アイデンティティと検証
エンドポイント 1
主な機能 4
よくある質問 4

これらの企業の担当者に使われています

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

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

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

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

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

OpenAPI API アーティファクト

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

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

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

1,000 無料クレジット

毎月1,000クレジットを無料で使い始められます。足りない場合は、月額プランを選ぶか、一回限りのパックを購入してください。

この API で実装できること

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

プロダクトワークフロー

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

アナリスト自動化

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

クリーンな JSON データ

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

AI と運用ツール

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

統合ワークフロー

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

1
一度認証する

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

2
例から問い合わせる

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

3
運用と監視

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

開発者キット

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

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

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

リクエストパラメータ

パラメータ

domaintickerexchangeisinname
レスポンスフィールド

レスポンス例

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method
ステータス範囲

HTTP ステータスコード

200304400401402429

エンドポイント

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

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

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

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

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

OpenAPI API アーティファクト

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

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

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

1,000 無料クレジット

毎月1,000クレジットを無料で使い始められます。足りない場合は、月額プランを選ぶか、一回限りのパックを購入してください。

主な機能

ロゴから読み取ったカラー

パレットはデコードしたロゴのピクセルから作られ、透明な領域や単色の背景は除外されます。形式は hex、RGB、OKLCH です。ウェブサイトが宣言している theme_color は別に報告されます。

正方形ロゴと横長ロゴ

正方形のブランドマークと、ウェブサイトが公開している場合はヘッダー用の横長ロゴやワードマークを取得できます。どちらもダウンロードしてデコードしてから返されます。

不明は「なし」ではありません

各フィールドは、あり、なし、不明のいずれかを示します。ブロックされたりタイムアウトしたりしたウェブサイトは、空ではなく不明のフィールドになります。複数の企業に一致するティッカーは、推測せずに候補を返します。

ブランド変更時のアラート

ブランドアラートの購読でブランドドメインを監視すると、ロゴ、カラー、名称、ソーシャルプロフィールが変わったときに、Webhookで brand.updated を受け取れます。

リクエスト例

GET /v1/brand?domain=stripe.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

レスポンス例

200 OK json
{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

よくある質問

ブランド検索は何クレジットかかりますか?

1リクエストにつき3クレジットです。「なし」や「不明」の応答も同様です。無効なリクエスト、およびDomScan自身の企業データが利用できず失敗した検索は返金されます。応答に含まれる各ロゴ画像URLは、取得するたびに1クレジットかかります。

ブランドデータを保存できますか?

はい。結果とロゴは、ご自身のシステムでキャッシュ・保存できます。応答には ETag とキャッシュヘッダーが含まれているため、保存したコピーを再検証できます。ロゴと名称は、それぞれの所有者の商標です。

ブランドカラーはどこから取得されますか?

デコードしたロゴのピクセルからです。似た色はまとめられ、透明部分と単色の背景は除外され、同じロゴからは常に同じパレットが得られます。ウェブサイトが宣言している theme_color は別のフィールドです。

株式ティッカーでブランドを検索できますか?

はい。domain の代わりに、ticker(必要に応じて exchange も指定)、isin、または name を送信してください。ドメインは、一致する企業がちょうど1社の場合にのみ使われます。それ以外の場合は、理由と候補を添えて「不明」が返ります。

関連ツールとリソース

HTTP ステータスコード

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

成功 200

リクエスト成功

HTTP 304 304

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

不正なリクエスト 400

無効なパラメータ

未認証 401

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

支払いが必要 402

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

リクエスト過多 429

レート制限を超過