Аналитика доменов · Продукт DomScan

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

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

Что вы получите

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

АсинхронныйRESTMCPSDK

Выберите этот продукт, если

Для кого этот продукт

Используйте отдельные проверки для одного решения или соберите расширенный профиль, когда важен контекст.

Выберите этот продукт, если

Выбирайте для проверки сочетаний из англоязычного корпуса одиночных слов по 1-5 TLD, до 100 проверок слов и TLD на задачу.

Что вы получите

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

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

Перед интеграцией изучите поддерживаемые операции, входные и выходные данные, режимы выполнения и ограничения ответа.

POST /v1/domain-discovery/jobs Открыть справочник API

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

1 Требуется аутентификация. Точную стоимость и правила оплаты каждого элемента см. в справочнике операции.

Пример операции

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

POST /v1/domain-discovery/jobs

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

Параметр Тип обязателен
tlds string[] обязателен
limit integer опционально
cursor string опционально
min_length integer
По умолчанию 3
опционально
max_length integer
По умолчанию 16
опционально
singular_only boolean
По умолчанию false
опционально

Поля ответа

Поле Тип
job object
job.id string
job.status string
job.total integer
job.counts object
job.counts.pending integer
job.counts.processing integer
job.counts.succeeded integer
job.counts.failed integer
job.counts.cancelled integer
job.billing object
job.billing.credits_charged integer
job.billing.credits_refunded integer
job.billing.credits_net integer
job.webhook object
job.webhook.configured boolean
job.webhook.status string
job.webhook.attempts integer
job.status_url string
job.results_url string
job.results_csv_url string
job.poll_after_ms integer | null
job.created_at string
job.started_at string | null
job.completed_at string | null
job.cancelled_at string | null
job.updated_at string
job.processing_deadline_at string
job.results_expires_at string
discovery object
discovery.corpus string
discovery.corpus_version string
discovery.total_matching_words integer
discovery.page_offset integer
discovery.page_words integer
discovery.domain_checks integer
discovery.tlds[] string[]
discovery.filters object
discovery.filters.min_length integer
discovery.filters.max_length integer
discovery.filters.singular_only boolean
discovery.credits_per_domain integer
discovery.next_cursor string | null

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

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

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

{
  "job": {
    "id": "example-id",
    "status": "queued",
    "total": 1,
    "counts": {
      "pending": 1,
      "processing": 1,
      "succeeded": 1,
      "failed": 1,
      "cancelled": 1
    },
    "billing": {
      "credits_charged": 1,
      "credits_refunded": 1,
      "credits_net": 1
    },
    "webhook": {
      "configured": false,
      "status": "not_configured",
      "attempts": 1
    },
    "status_url": "https://example.com",
    "results_url": "https://example.com",
    "results_csv_url": "https://example.com",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z",
    "processing_deadline_at": "2026-08-27T12:00:00Z",
    "results_expires_at": "2026-08-27T12:00:00Z",
    "poll_after_ms": 1,
    "started_at": "2026-08-27T12:00:00Z",
    "completed_at": "2026-08-27T12:00:00Z",
    "cancelled_at": "2026-08-27T12:00:00Z"
  },
  "discovery": {
    "corpus": "iannuttall/unclaimed",
    "corpus_version": "example",
    "total_matching_words": 1,
    "page_offset": 1,
    "page_words": 1,
    "domain_checks": 1,
    "tlds": [
      "com",
      "net",
      "org"
    ],
    "filters": {
      "min_length": 1,
      "max_length": 1,
      "singular_only": false
    },
    "credits_per_domain": 1,
    "next_cursor": "example"
  }
}

Ограничения и границы доказательств

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

Проверено 2026-08-22

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

Где найти справочник запросов и ответов для Рецепт Поиска Доменов?

В справочнике API для Рецепт Поиска Доменов описаны параметры, поля ответа, примеры, коды состояния и поддерживаемые режимы выполнения.

Как интерпретировать неизвестные или неполные результаты Рецепт Поиска Доменов?

Неизвестный или частичный результат означает, что запрошенные данные не удалось определить полностью. Учитывайте состояние результата, уверенность, актуальность и ограничения при дальнейших решениях.

Как рассчитывается цена Рецепт Поиска Доменов?

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

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

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeMotionElementsLLM Pulse