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

Ограничения частоты

DomScan API для анализа доменов: Каждый аутентифицированный ответ, успешный или с ошибкой, содержит эти заголовки, а браузеры могут читать их через CORS.

Ограничения частоты

  • Бесплатные аккаунты: 300 запросов в минуту с всплеском до 60. Этот budget общий для всех API ключей и сеансов dashboard в аккаунте.
  • Платные аккаунты: 900 запросов в минуту с всплеском до 120. Этот budget общий для всех API ключей и сеансов dashboard в аккаунте.
  • Корпоративные и ежемесячные планы для больших объёмов: Индивидуальные лимиты, согласованные с нашей командой под вашу нагрузку. Пока такой лимит действует, X-RateLimit-Policy содержит custom и указывает согласованную скорость и burst. Связаться с отделом продаж
  • Запросы без ключа API: 600 запросов в минуту на один IP-адрес, burst 20.
  • Bulk endpoints для бесплатных аккаунтов: Дополнительно 20 запросов в минуту на каждый аккаунт и 100 запросов в минуту на каждую сеть.
  • Кэшированные запросы (prefer_cache=1): По-прежнему учитываются в вашем лимите, но они отвечают быстрее и пропускают upstream поиск.
  • Bulk-эндпоинт: 50 доменов на запрос
  • TLD на запрос: Максимум 50
Превышение лимита возвращает HTTP 429 с заголовком Retry-After. Каждый authenticated response содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Policy, поэтому вы можете отслеживать оставшийся budget вместо угадывания.

Заголовки лимита запросов

Каждый аутентифицированный ответ, успешный или с ошибкой, содержит эти заголовки, а браузеры могут читать их через CORS. Используйте их, чтобы регулировать темп запросов, а не ждать ответа 429.

ЗаголовокО чём он сообщает
X-RateLimit-PlanКакой лимит действует: free, paid или standard для запросов без ключа API.
X-RateLimit-LimitВаша ёмкость burst: сколько запросов можно отправить одновременно.
X-RateLimit-RemainingСколько запросов вы можете отправить прямо сейчас, пока лимит не вступил в силу.
X-RateLimit-ResetВремя Unix в секундах, когда ёмкость burst снова будет полной.
X-RateLimit-PolicyПолная политика в машиночитаемом виде, например paid; sustained=900; burst=120; scope=account; window=60.
Retry-AfterОтправляется вместе с HTTP 429: сколько секунд ждать перед повторной попыткой.