アイデンティティと検証

アバター・ロゴ検索API

すべてのユーザー、リード、企業の横に本物の顔やロゴを表示できます。メールアドレス、ユーザー名、ドメインのいずれかを送信すると、最適な検証済み画像とその取得元が返され、画像がない場合も正直にその旨を返します。

エンドポイントアクティブ

GET /v1/avatar

リクエスト例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

レスポンス例 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

リクエスト例 GET /v1/avatar

主な機能 4

よくある質問 4

HTTP ステータスコード 200 / 400 / 401 / 402 / 429

カテゴリ アイデンティティと検証

エンドポイント 1

主な機能 4

よくある質問 4

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

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

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

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

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

OpenAPI API アーティファクト

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

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

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

1,000 無料枠

UTC暦月あたり1,000クレジットで無料で始められます。さらに必要な場合は、任意の月額プランを選ぶか、一回限りのパックを購入できます。

この API で実装できること

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

プロダクトワークフロー

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

アナリスト自動化

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

クリーンな JSON データ

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

AI と運用ツール

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

統合ワークフロー

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

一度認証する

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

例から問い合わせる

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

運用と監視

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

開発者キット

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

OpenAPI スキーマ

クライアント生成やリクエスト/レスポンス形状の確認に使えます。

Postman コレクション

手動テストやチーム共有用のリクエストをすぐインポートできます。

SDK と CLI

ボイラープレートを書く代わりに、保守済みパッケージとコマンドラインワークフローを使えます。

MCP 統合

ドメインインテリジェンスを AI エージェントや社内アシスタントに公開します。

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

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

リクエストパラメータ

パラメータ

emailusernameplatformdomain

レスポンスフィールド

レスポンス例

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

ステータス範囲

HTTP ステータスコード

200400401402429

エンドポイント

GET /v1/avatar

クレジット: 2認証: 認証が必要です

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

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

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

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

OpenAPI API アーティファクト

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

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

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

1,000 無料枠

UTC暦月あたり1,000クレジットで無料で始められます。さらに必要な場合は、任意の月額プランを選ぶか、一回限りのパックを購入できます。

主な機能

メール、ユーザー名、ドメイン

メールアドレスは、公開アバターサービスおよびメールドメインの企業ロゴと照合されます。ユーザー名は GitHub、Bluesky、Mastodon、Keybase で確認されます。ドメインの場合はウェブサイトのロゴを返します。

検証済みの画像のみ

返されるすべての画像はダウンロードされ、本物の画像であることが確認されます。エラーページ、リンク切れ、デフォルトのプレースホルダーが返されることはありません。

すべてのソースに根拠を付与

各ソースは present、absent、unknown のいずれかを理由とともに報告するため、画像がないことと、応答がなかったソースが混同されることはありません。

必要なときに最新の結果を

結果は数時間再利用されます。max_age を指定すると保存済み回答の許容経過時間を設定でき、max_age=0 を指定すると新規にチェックします。

リクエスト例

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

レスポンス例

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

よくある質問

どのソースを確認しますか?

メールの場合: Gravatar、Libravatar、企業メールドメインの BIMI ロゴ。ユーザー名の場合: GitHub、Bluesky、Mastodon、Keybase、または選択したプラットフォームのみ。ドメインの場合: ウェブサイトが公開しているロゴまたはアイコンと、その BIMI ロゴ。

absent は何を意味しますか?

すべてのソースが、画像がないことを明確に回答した状態です。アカウントがない、アカウントに画像がない、公開ロゴがない、のいずれかが該当します。ブロックされた、遅い、または不明確なソースが1つでもあれば、結果は代わりに unknown になります。

GitHub の画像が自動生成の可能性ありと表示されるのはなぜですか?

GitHub は画像をアップロードしていないアカウントに自動生成パターンを割り当て、アカウントがどちらの種類かは示しません。そのような画像がアバターとして返されることはありません。他のソースと並べて一覧に表示され、フラグが付きます。それが唯一見つかった画像の場合、結果は unknown になります。

クレジットはいくらかかりますか?

確認したソースの数にかかわらず、1回の検索につき2クレジットです。unknown の結果は返金されます。

HTTP ステータスコード

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

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

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

支払いが必要 402

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

リクエスト過多 429

レート制限を超過

アバターを検索

無料で開始ドキュメントを見る

サポート

アバター・ロゴ検索API

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

この API で実装できること

統合ワークフロー

開発者キット

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

エンドポイント

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

主な機能

リクエスト例

レスポンス例

よくある質問

関連ツールとリソース

HTTP ステータスコード