Справочник разработчика

Кредиты и цены

DomScan API для анализа доменов: DomScan даёт вам 1 000 бесплатных кредитов каждый месяц. Банковская карта не нужна.

Кредиты и цены

DomScan даёт вам 1 000 бесплатных кредитов каждый месяц. Банковская карта не нужна.

Бесплатные кредиты обновляются 1-го числа каждого месяца (00:00 UTC).. Нужно больше кредитов? Выберите необязательный ежемесячный план или купите разовый пакет. Срок действия кредитов из купленного пакета не истекает:

Кредиты на конечную точку

Ниже указана стоимость распространённых эндпоинтов. Некоторые справочные эндпоинты бесплатны. Полная машиночитаемая тарифная таблица доступна через /v1/pricing.

Конечная точкаКредитыОписание
/v1/coverage 0 Список TLD с сопоставлениями RDAP
/v1/tlds 0 Список метаданных TLD
/v1/watchlist 1 Просмотрите ваш список наблюдения
/v1/webhooks 2 За каждое оповещение, доставленное на вашу конечную точку вебхука. За неудачные доставки кредиты возвращаются, а тестовые события бесплатны.
/v1/status 1 Проверка доступности домена
/v1/health/quick 1 Быстрая проверка здоровья
/v1/dns 1 DNS поиск
/v1/dns/bulk 1/domain Пакетный DNS-поиск (до 25 доменов)
/v1/ip 1 Геолокация IP
/v1/value 2 Оценка стоимости домена
/v1/prices 0-1/pair Цены на регистрацию
/v1/tlds/:tld 1 Детали TLD
/v1/watchlist/check 1 Проверка элемента списка наблюдения
/v1/typos/permutations 1 Перестановки опечаток
/v1/typos/score 1 Оценка риска опечатки
/v1/email/check 1 Проверка черного списка электронной почты
/v1/status/bulk 1/domain Проверьте доступность для нескольких имен доменов одновременно. Поддерживает до 50 доменов за запрос.
/v1/health 3 Полная проверка здоровья
/v1/dns/all 2 Все DNS записи
/v1/profile 3 Профиль домена
/v1/redirects 2 Цепь перенаправлений
/v1/tech 3-9 Определение технологического стека
/v1/categorize 3 Категоризация веб-сайта
/v1/similarity 2 Сходство доменов
/v1/typos 2-3 Обнаружение опечаток
/v1/reputation 3 Репутация домена
/v1/reputation/bulk 3/domain Пакетная репутация доменов (до 3 доменов)
/v1/certificates 2 SSL сертификат
/v1/certificates/bulk 2/domain SSL сертификат
/v1/social 2 Проверка социального профиля
/v1/social/bulk 2/handle Массовая проверка имен пользователей в соцсетях
/v1/company 3 Поиск компании
/v1/suggest 2-5 Рекомендации по доменам
/v1/whois 3 WHOIS поиск
/v1/whois/history 3 История изменений WHOIS
/v1/whois/bulk 3/domain Массовый запрос WHOIS (до 20 доменов)
/v1/rdap/bulk 2/query WHOIS поиск
/v1/prices/bulk 1/pair Массовые цены
/v1/dns/security 3 Анализ безопасности DNS
/v1/dns/propagation 2 Распространение DNS
/v1/dns/propagation/bulk 2/domain Распространение DNS
/v1/email-auth/bulk 3/domain Аутентификация электронной почты
/v1/hosting/bulk 3/domain Определение хостинга
/v1/value/bulk 2/domain Массовая оценка стоимости
/v1/health/bulk 3/domain Массовая проверка здоровья
/v1/subdomains 4-5 Поиск поддоменов
/v1/subdomains/bulk 4-5/domain Поиск поддоменов
/v1/report 5 Комплексный отчет (экономит ~10 кредитов в сравнении с отдельными вызовами)

Применение кредитов

Когда ваши кредиты достигают нуля, запросы API, требующие кредитов, возвращают HTTP 402 (Payment Required). Бесплатные браузерные инструменты не затронуты.

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

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

Бесплатные кредиты обновляются 1-го числа каждого месяца (00:00 UTC)..

Заголовки ответа кредитов

Все аутентифицированные ответы API включают заголовок X-Credits-Remaining, показывающий ваш текущий баланс кредитов после запроса.

X-Credits-Remaining: 9500

Каждый ответ /v1 для аутентифицированных запросов, включая ошибки, содержит эти заголовки:

  • X-Credits-Charged: кредиты, списанные за этот запрос, за вычетом возврата в рамках того же запроса (0, если ничего не списано).
  • X-Credits-Remaining: ваш баланс после запроса. Не возвращается в редком случае, когда баланс заранее неизвестен.
  • X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset: ваш пиковый лимит, число запросов, которые можно отправить сразу, и время Unix в секундах, когда лимит полностью восстановится.
  • MCP по HTTP возвращает X-Credits-Charged и X-Credits-Remaining для вызовов инструментов в каждом запросе.

Оцените стоимость перед запуском

Отправьте метод, путь, параметры запроса и тело запроса на POST /v1/estimate, чтобы узнать, сколько кредитов он спишет, с разбивкой и примечаниями. Ничего не выполняется, а сама оценка стоит 0 кредитов. Если итоговая сумма зависит от результата, оценка является максимумом, а примечание объясняет причину.

POST /v1/estimate

Тело запроса

ПараметрТипОписание
method обязателен string
Допустимые значения GETPOSTPUTPATCHDELETE
HTTP-метод оцениваемого запроса.
path обязателен string Путь оцениваемого запроса, например /v1/value/bulk. Строка запроса в пути тоже учитывается.
query опционально object Параметры запроса в виде объекта. Массивы соединяются через запятую.
body опционально any Тело JSON, которое отправил бы запрос.

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

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

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

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Запросы, отклоненные со статусом 4xx или завершившиеся ошибкой со статусом 5xx, возвращаются автоматически."],
  "maximum": false,
  "rejected": false
}

Поля ответа

Поле Тип
credits integer
breakdown[] object[]
breakdown[] object
breakdown[].component string
breakdown[].quantity integer
breakdown[].unit_credits number
breakdown[].credits integer
notes[] string[]
maximum boolean
rejected boolean
billing_model string
endpoint object
endpoint.method string
endpoint.path string
dry_run boolean

Эндпоинты bulk, compare, recipe и pricing также принимают dry_run=true. Запрос получает ответ HTTP 200 с той же оценкой и полем "dry_run": true, без выполнения и без списания кредитов.

Отправить отзыв

Сообщите об ошибке, неверных или отсутствующих данных, недостающей функции или проблеме в документации либо расскажите, что работает хорошо. Полное сообщение сразу попадает к команде DomScan вместе с вашим аккаунтом. Отправка отзывов бесплатна, каждый аккаунт может отправлять до 10 сообщений в час. ИИ-агенты могут использовать MCP-инструмент send_feedback.

POST /v1/feedback

Тело запроса

ПараметрТипОписание
message обязателен string Отзыв простыми словами, до 3 000 символов. Опишите, что вы ожидали и что произошло. API-ключи и bearer-токены удаляются перед отправкой сообщения.
category опционально string
Допустимые значения bugfeature_requestdata_qualitydocspraiseother
О чём отзыв. Значение по умолчанию: other.
tool опционально string MCP-инструмент или путь API, к которому относится отзыв, до 120 символов.

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

curl -X POST "https://domscan.net/v1/feedback" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"message":"WHOIS for example.io returns no registrar.","category":"data_quality","tool":"/v1/whois"}'

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

{
  "received": true,
  "feedback_id": "fbk_3f2c9a1b7d8e4f60a1b2c3d4e5f60718",
  "category": "data_quality"
}

Поля ответа

Поле Тип
received boolean
feedback_id string
category string

Калькулятор кредитов

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

Всего необходимо кредитов
100
Это 1.0% ваших бесплатных ежемесячных кредитов.

Пакеты кредитов

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

ПакетЦенаЗа кредит
10 000 кредитов$10.00 / €10.00 / £8.00 / ¥1,700$0.00100
50 000 кредитов$30.00 / €28.00 / £24.00 / ¥5,000$0.00060
250 000 кредитов$85.00 / €80.00 / £67.00 / ¥14,000$0.00034
1 000 000 кредитов$269.00 / €255.00 / £210.00 / ¥45,000$0.00027

Ежемесячные планы

Ежемесячные планы необязательны и начинаются только тогда, когда вы их выбираете. Мы никогда не переводим вас на платный план и не списываем деньги без вашего согласия. Платный план заменяет ваши бесплатные кредиты, пока он действует. Кредиты плана обновляются в каждом расчётном периоде; неиспользованные кредиты сгорают в конце периода и не переносятся.

  • Starter: 25 000 кредитов за расчётный период, Оплата ежемесячно: $6.00 / Оплата ежемесячно: €6.00 / Оплата ежемесячно: £5.00 / Оплата ежемесячно: ¥1,000
  • Pro: 100 000 кредитов за расчётный период, Оплата ежемесячно: $19.00 / Оплата ежемесячно: €18.00 / Оплата ежемесячно: £15.00 / Оплата ежемесячно: ¥3,200
  • Scale: 500 000 кредитов за расчётный период, Оплата ежемесячно: $49.00 / Оплата ежемесячно: €46.00 / Оплата ежемесячно: £39.00 / Оплата ежемесячно: ¥8,100
  • Scale 1M: 1 000 000 кредитов за расчётный период, Оплата ежемесячно: $95.00 / Оплата ежемесячно: €89.00 / Оплата ежемесячно: £74.00 / Оплата ежемесячно: ¥16,000
  • Scale 3M: 3 000 000 кредитов за расчётный период, Оплата ежемесячно: $279.00 / Оплата ежемесячно: €260.00 / Оплата ежемесячно: £220.00 / Оплата ежемесячно: ¥46,000
  • Scale 10M: 10 000 000 кредитов за расчётный период, Оплата ежемесячно: $915.00 / Оплата ежемесячно: €855.00 / Оплата ежемесячно: £715.00 / Оплата ежемесячно: ¥151,000
  • Scale 25M: 25 000 000 кредитов за расчётный период, Оплата ежемесячно: $2,240.00 / Оплата ежемесячно: €2,090.00 / Оплата ежемесячно: £1,740.00 / Оплата ежемесячно: ¥369,000
  • Scale 50M: 50 000 000 кредитов за расчётный период, Оплата ежемесячно: $4,390.00 / Оплата ежемесячно: €4,090.00 / Оплата ежемесячно: £3,410.00 / Оплата ежемесячно: ¥723,000