Веб-данные

API проверки ads.txt и sellers.json

Узнайте, какие компании авторизованы продавать рекламный инвентарь сайта. Разберите ads.txt или app-ads.txt, отметьте недопустимые строки и дубли и подтвердите каждого продавца по собственному sellers.json рекламной системы.

Category Веб-данные
Конечные точки 1
Ключевые возможности 4
Часто задаваемые вопросы 4

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

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

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

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

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

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

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

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

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

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

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

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметр

urlfileverify_sellers
Поля ответа

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

statussummarysummary.recordssummary.directsummary.resellersummary.ad_systemsvariablesvariables.ownerdomainissuessellerssellers.systems_checkedsellers.confirmed
Покрытие статусов

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

200400401402429

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

GET /v1/ads-txt
Кредиты: 2-5Аутентификация: Требуется аутентификация

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

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

Статус сервиса API-артефакты

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

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

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

Бесплатный лимит Зарегистрируйтесь бесплатно

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Активен Пример запроса

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

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

ads.txt и app-ads.txt

Проверка веб-файла или версии для мобильных приложений и подключённых телевизоров: каждая запись, тип отношений и ID сертификационного центра.

Подтверждение продавцов

При verify_sellers=true каждый ID продавца ищется в sellers.json рекламной системы и получает статус confirmed, confidential, type mismatch или not found.

Проверка синтаксиса

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

Переменные

Объявления OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN и INVENTORYPARTNERDOMAIN возвращаются в том виде, в котором найдены.

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

GET /v1/ads-txt?url=example.com&verify_sellers=true bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ads-txt?url=example.com&verify_sellers=true"

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

200 OK json
{
  "status": "found",
  "summary": { "records": 401, "direct": 94, "reseller": 307, "ad_systems": 98 },
  "variables": { "ownerdomain": ["example.com"] },
  "issues": [{ "code": "duplicate_record", "count": 47, "lines": [68, 76, 77] }],
  "sellers": {
    "systems_checked": 10,
    "confirmed": 58,
    "type_mismatch": 7,
    "seller_not_found": 16,
    "unknown": 9
  }
}

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

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

В sellers.json есть ID продавца, но с типом, не соответствующим типу отношений, например запись PUBLISHER для строки RESELLER.

Почему некоторые продавцы получают статус unknown?

sellers.json рекламной системы не удалось прочитать, он оказался слишком большим или имел неверный формат. Статус unknown никогда не означает, что продавца нет в списке.

Сколько рекламных систем проверяется?

До 10 за запрос, начиная с систем с наибольшим числом записей и отношений DIRECT.

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

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

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

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

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

OK 200

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

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

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

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

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

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

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

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

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