アイデンティティと検証

ロゴ画像API

プロダクト内のすべてのドメインの横に、企業ロゴを表示しましょう。/v1/logo/ の後ろにドメインを付けてリクエストするだけで、imgタグにそのまま使える適切なサイズの正方形PNGが返り、取得元を示すヘッダーも付きます。画像はキャッシュ、保存し、自社サーバーやCDNから配信してかまいません。

カテゴリ アイデンティティと検証
エンドポイント 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、エージェント用ツールへすぐ移動できます。

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

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

リクエストパラメータ

パラメータ

domain
レスポンスフィールド

レスポンス例

successdatameta
ステータス範囲

HTTP ステータスコード

401402

エンドポイント

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

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

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

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

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

OpenAPI API アーティファクト

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

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

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

1,000 無料クレジット

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

主な機能

本物のロゴ、または正直な回答

ロゴは企業自身が公開しているもの(BIMIのメールロゴ、アプリアイコン、タッチアイコン、構造化データのロゴ、ファビコン)から取得します。すべての画像は、返す前にダウンロードしてデコードを確認します。ロゴがない場合は404を返し、fallback=monogram を指定すると生成された頭文字の画像を返します。生成した画像であることは必ず明示されます。

画面に合わせたサイズ

16~512ピクセルの任意のサイズ、2倍密度のretina、greyscale、そしてtheme=lightまたはtheme=darkを選べます。コントラストの低いロゴも、背景の上で見えるタイルに載せて表示できます。画像は透明な余白付きの正方形です。

キャッシュも保存も自由

レスポンスには長期間有効な公開キャッシュヘッダー、ETag、Last-Modifiedが含まれます。ブラウザーやCDNが保持でき、ファイルを保存して自社サーバーから配信することもできます。URLに v= を付けると、内容が変わらないURLにできます。

ウェブページでも安心して使える

tokenパラメーターに公開用キーを指定すると、登録したウェブサイトからのみ動作し、キーごと、訪問者ごとの制限も適用されます。シークレットキーはサーバー上でX-API-Keyヘッダーに指定して使います。

リクエスト例

GET /v1/logo/stripe.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"
html
<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">

レスポンス例

200 OK json
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999

よくある質問

ロゴ1件に何クレジットかかりますか?

1リクエストにつき1クレジットです。キャッシュから返したロゴ、生成した頭文字の画像、ロゴのないドメイン、304 Not Modifiedの応答も同様です。無効なドメインや許可されていないサイトで使われたキーなど、処理の前に拒否されたリクエストには課金されません。ページを表示するたびに取得せず、画像をキャッシュしてください。

ロゴを自社サーバーに保存できますか?

はい。返された画像をキャッシュし、保存して、自社サーバーやCDNから配信できます。ロゴはそれぞれの所有者の商標のままですので、そのロゴが属する企業を示す目的で使用してください。

「見つからない」と「利用不可」の違いは何ですか?

「見つからない」は、ウェブサイトとそのメールレコードが応答し、利用できるロゴが公開されていないことを意味します。この結果は1時間再利用されます。「利用不可」は、ウェブサイトにブロックされた、応答が遅かった、または応答が不明確だったために結論を出せなかったことを意味し、数分後に再試行できます。X-Logo-Statusで両者を区別できます。

ロゴの取得元はどうすれば分かりますか?

X-Logo-Sourceに、bimi、manifest_icon、touch_icon、faviconなどの取得元が入り、X-Logo-Verificationは画像をデコードして確認済みであることを示します。生成された頭文字の画像には必ず X-Logo-Source: generated が付き、ロゴとして扱われることはありません。

関連ツールとリソース

HTTP ステータスコード

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

未認証 401

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

支払いが必要 402

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