> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ru/docs/rate-limits

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

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

- **Бесплатные аккаунты:** 300 запросов в минуту с всплеском до 60. Этот budget общий для всех API ключей и сеансов dashboard в аккаунте.

- **Платные аккаунты:** 900 запросов в минуту с всплеском до 120. Этот budget общий для всех API ключей и сеансов dashboard в аккаунте.

- **Корпоративные и ежемесячные планы для больших объёмов:** Индивидуальные лимиты, согласованные с нашей командой под вашу нагрузку. Пока такой лимит действует, `X-RateLimit-Policy` содержит `custom` и указывает согласованную скорость и burst. [Связаться с отделом продаж](https://domscan.net/ru/enterprise)

- **Запросы без ключа 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: сколько секунд ждать перед повторной попыткой. |
