Справочник разработчика
Ограничения частоты
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: сколько секунд ждать перед повторной попыткой. |