API для Рецепт Поиска Доменов

Q: Какие конечные точки включены?

Это руководство охватывает 4 общедоступных конечных точек: POST /v1/domain-discovery/jobs , GET /v1/batches/:job_id , GET /v1/batches/:job_id/results , DELETE /v1/batches/:job_id .

Ставьте в очередь множество поддерживаемых запросов API и получайте результаты, не удерживая клиентское соединение открытым.

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \ -H "X-API-Key: $DOMSCAN_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: discovery-com-io-1" \ -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

{ "job": { "id": "bat_...", "status": "queued", "total": 50, "status_url": "https://domscan.net/v1/batches/bat_...", "results_url": "https://domscan.net/v1/batches/bat_.../results" }, "discovery": { "page_words": 25, "tlds": ["com", "io"], "domain_checks": 50, "credits_per_domain": 1, "next_cursor": "..." } }

Category Аналитика доменов

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

Кредиты 0-1/item

Аутентификация Требуется аутентификация

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

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

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить 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

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

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

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

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

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

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

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

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

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

Схема OpenAPI

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

Коллекция Postman

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

SDK и CLI

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

Интеграция MCP

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

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

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

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

Параметр

tldslimitcursormin_lengthmax_lengthsingular_onlyjob_idafterformat

Поля ответа

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

jobjob.idjob.statusjob.totaljob.status_urljob.results_urldiscoverydiscovery.page_wordsdiscovery.tldsdiscovery.domain_checksdiscovery.credits_per_domaindiscovery.next_cursor

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

Коды статуса HTTP

200202400401402409429

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

POST /v1/domain-discovery/jobs

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

tldslimitcursormin_lengthmax_lengthsingular_only

GET /v1/batches/:job_id

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

job_id

GET /v1/batches/:job_id/results

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

job_idafterlimitformat

DELETE /v1/batches/:job_id

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

job_id

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

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

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

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

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

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

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

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

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

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

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

POST /v1/domain-discovery/jobs • GET /v1/batches/:job_id • GET /v1/batches/:job_id/results • DELETE /v1/batches/:job_id

Параметр

tlds, limit, cursor, min_length, max_length, singular_only, job_id, after, format

Коды статуса HTTP

200, 202, 400, 401, 402, 409, 429

Кредиты / Аутентификация

0-1/item / Требуется аутентификация

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

POST /v1/domain-discovery/jobs bash

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: discovery-com-io-1" \
  -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

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

202 Accepted json

{
  "job": {
    "id": "bat_...",
    "status": "queued",
    "total": 50,
    "status_url": "https://domscan.net/v1/batches/bat_...",
    "results_url": "https://domscan.net/v1/batches/bat_.../results"
  },
  "discovery": {
    "page_words": 25,
    "tlds": ["com", "io"],
    "domain_checks": 50,
    "credits_per_domain": 1,
    "next_cursor": "..."
  }
}

Заголовок

Какие конечные точки включены?

Это руководство охватывает 4 общедоступных конечных точек: POST /v1/domain-discovery/jobs, GET /v1/batches/:job_id, GET /v1/batches/:job_id/results, DELETE /v1/batches/:job_id.

Требуется ли для этого API аутентификация?

Да. Передавайте ключ API в заголовке `X-API-Key` или `Authorization: Bearer` при вызове Рецепт Поиска Доменов.

Сколько кредитов он использует?

Запросы в этих руководствах используют 0-1/item кредитов в зависимости от эндпоинта. Для массовых эндпоинтов кредиты рассчитываются по стандартной ставке за элемент.

Где посмотреть полные параметры и связанные конечные точки?

Используйте полную документацию для Рецепт Поиска Доменов, чтобы ознакомиться с деталями параметров, примечаниями по аутентификации и связанными конечными точками в той же API-группе.

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

Коды статуса HTTP

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

OK 200

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

Принято 202

Промах кэша поддоменов в режиме только кэша принят для фонового обновления. Кредиты не списываются; повторите запрос после задержки Retry-After.

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

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

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

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

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

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

HTTP 409 409

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

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

Начните бесплатно с 10 000 кредитов в месяц. Используйте любой общедоступный API и добавляйте кредиты только при необходимости.

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