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

API изображений логотипов

Показывайте логотип компании рядом с каждым доменом в вашем продукте. Запросите /v1/logo/ с доменом и получите квадратный PNG нужного размера, готовый для тега img, с заголовками, которые указывают источник. Изображения можно кэшировать, хранить и отдавать со своих серверов или через свой CDN.

Просмотреть документацию Изучить все API

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

GET /v1/logo/:domain

Пример запроса

curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"

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

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

Пример запроса GET /v1/logo/stripe.com

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

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

Коды состояния HTTP 401 / 402

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

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

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

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

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

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

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

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

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

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

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

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

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

1 000 Бесплатные кредиты

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

Что помогает запустить эта 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 к клиенту.

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

Параметр

domain

Поля ответа

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

successdatameta

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

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

401402

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

GET /v1/logo/:domain

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

domain

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

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

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

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

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

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

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

1 000 Бесплатные кредиты

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

Настоящий логотип или честный ответ

Логотипы берутся из того, что публикует сама компания: почтовый логотип BIMI, значки приложений, touch-иконки, логотипы из структурированных данных и фавиконы. Каждое изображение скачивается и декодируется до возврата. Если логотипа нет, вы получите 404 или, с fallback=monogram, сгенерированное изображение с буквой, которое всегда помечено как сгенерированное.

Размер под ваш интерфейс

Выбирайте любой размер от 16 до 512 пикселей, retina для двойной плотности, greyscale, а также theme=light или theme=dark, чтобы разместить малоконтрастные логотипы на плитке, которая остаётся заметной на вашем фоне. Изображения квадратные, с прозрачными полями.

Кэшируйте и храните

Ответы содержат долгоживущие публичные заголовки кэширования, ETag и Last-Modified. Браузеры и ваш CDN могут их сохранять, а вы можете хранить файлы и отдавать их со своих серверов. Добавьте 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

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

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

Один кредит за запрос, включая логотипы из кэша, сгенерированные изображения с буквой, домены без логотипа и ответы 304 Not Modified. Запросы, отклонённые до какой-либо обработки, например с недопустимым доменом или с ключом, использованным на неразрешённом сайте, не тарифицируются. Кэшируйте изображение, а не запрашивайте его при каждом просмотре страницы.

Можно ли хранить логотипы на своих серверах?

Да. Вы можете кэшировать возвращённые изображения, хранить их и отдавать со своих серверов или через свой CDN. Логотипы остаются товарными знаками своих владельцев, поэтому используйте их, чтобы обозначать компанию, которой они принадлежат.

В чём разница между «не найдено» и «недоступно»?

«Не найдено» означает, что сайт и его почтовые записи ответили и не публикуют подходящего логотипа; этот ответ используется повторно в течение часа. «Недоступно» означает, что сайт заблокировал запрос, ответил медленно или нечётко, поэтому вывод не сделан, и можно повторить попытку через несколько минут. Различить их помогает X-Logo-Status.

Как узнать, откуда взят логотип?

X-Logo-Source называет источник, например bimi, manifest_icon, touch_icon или favicon, а X-Logo-Verification сообщает, что изображение декодировано. У сгенерированного изображения с буквой всегда стоит X-Logo-Source: generated, и оно никогда не выдаётся за логотип.

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

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

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

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

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

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

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

Получить логотип

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