Идентичность и верификация

API поиска аватаров и логотипов

Показывайте настоящее лицо или логотип рядом с каждым пользователем, лидом и компанией. Передайте адрес электронной почты, имя пользователя или домен и получите лучшее проверенное изображение, его источник и честный ответ, если изображения нет.

Просмотреть документацию Изучить все 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

Category Идентичность и верификация

Конечные точки 1

Ключевые возможности 4

Часто задаваемые вопросы 4

Используется сотрудниками этих компаний

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Работает Статус сервиса

Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.

OpenAPI API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

1 000 Бесплатный лимит

Начните с 1 000 бесплатных кредитов за календарный месяц по UTC. Если нужно больше, выберите ежемесячный план или купите разовый пакет.

Что помогает запустить эта API

Используйте эту страницу как производственный бриф: конечные точки, примеры, форма ответа и элементы workflow для подключения DomScan к вашему продукту.

Продуктовые workflow

Встраивайте проверки доменов, DNS-интеллект, сигналы риска или обогащение в онбординг, поиск и внутренние инструменты.

Автоматизация аналитиков

Заменяйте повторяющиеся ручные проверки расписаниями, оповещениями и воспроизводимыми шагами расследования.

Чистые JSON-данные

Используйте предсказуемые поля, документированные коды состояния и стоимость в кредитах вместо scraping страниц провайдеров.

AI и ops-инструменты

Передавайте данные агентам, дашбордам, SOAR-плейбукам и CRM через OpenAPI, SDK, Postman или MCP.

Интеграционный workflow

Простой путь от первого запроса до повторяемого использования в продакшене.

Аутентифицируйтесь один раз

Передавайте API-ключ в документированном заголовке и сохраняйте единый формат запросов между сервисами.

Запрашивайте по примерам

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

Эксплуатируйте и мониторьте

Используйте коды состояния, стоимость кредитов и поля ответа для retries, логов и alerts.

Набор разработчика

Переходите к машиночитаемой документации, коллекциям запросов, SDK или инструментам для агентов.

Схема OpenAPI

Генерируйте клиенты или изучайте форму каждого запроса и ответа.

Коллекция Postman

Импортируйте готовые запросы для ручного тестирования и передачи команде.

SDK и CLI

Используйте поддерживаемые пакеты и командную строку вместо написания boilerplate.

Интеграция MCP

Открывайте доменную разведку AI-агентам и внутренним ассистентам.

Карта параметров и ответа

Просмотрите входы, поля ответа и коды состояния перед подключением endpoint к клиенту.

Параметры запроса

Параметр

emailusernameplatformdomain

Поля ответа

Пример ответа

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

Покрытие статусов

Коды состояния HTTP

200400401402429

Конечные точки

GET /v1/avatar

Кредиты: 2Аутентификация: Требуется аутентификация

Сигналы доверия перед интеграцией

Работает Статус сервиса

Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.

OpenAPI API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

1 000 Бесплатный лимит

Ключевые возможности

Email, имя пользователя или домен

Адреса электронной почты сопоставляются с публичными сервисами аватаров и с логотипом компании почтового домена. Имена пользователей проверяются в 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"
}

Часто задаваемые вопросы

Какие источники проверяются?

Для email: Gravatar, Libravatar и логотип BIMI почтового домена компании. Для имени пользователя: GitHub, Bluesky, Mastodon и Keybase либо только выбранная вами платформа. Для домена: логотип или значок, который публикует сайт, и его логотип BIMI.

Что означает absent?

Каждый источник чётко ответил, что у него нет изображения: нет аккаунта, у аккаунта нет фото или нет опубликованного логотипа. Если какой-либо источник был заблокирован, отвечал медленно или неясно, результатом будет unknown.

Почему фото из GitHub может быть помечено как возможно сгенерированное?

GitHub присваивает аккаунтам без загруженного фото сгенерированный узор и не сообщает, какой вариант у конкретного аккаунта. Такое изображение никогда не возвращается как аватар. Оно показывается среди других источников с пометкой, а если это единственное найденное изображение, результатом будет unknown.

Сколько кредитов это стоит?

Два кредита за один запрос независимо от числа проверенных источников. Результаты unknown возвращаются.

Связанные инструменты и ресурсы

Коды состояния HTTP

Это HTTP-коды состояния, которые нужно обрабатывать, чтобы различать успешные ответы, проблемы аутентификации, кредиты, лимиты запросов, отсутствующие данные и ошибки вышестоящих сервисов.

OK 200

Запрос выполнен успешно

Неверный запрос 400

Недопустимые параметры

Не авторизован 401

API-ключ или сессия отсутствует либо недействительна.

Требуется оплата 402

Недостаточно кредитов для выполнения этого запроса.

Слишком много запросов 429

Лимит скорости превышен

Найти аватар

Начать бесплатно Просмотреть документацию