> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Лимит запросов

> Лимит запросов для обеспечения стабильности и надёжности.

## Общее количество запросов к API

Общее количество ваших запросов к API определяется условиями вашего текущего тарифного плана Pubrio. Чтобы узнать свои месячные лимиты запросов, ознакомьтесь с информацией о ценах на API Pubrio.

Pubrio использует подход ограничения скорости с фиксированным окном для вызовов API. Например,

| Подписка     | Вызовы API (в час) | Вызовы API (в день) | Вызовы API (в месяц) |
| ------------ | ------------------ | ------------------- | -------------------- |
| Free         | `60`               | `1,440`             | `44,640`             |
| Growth       | `6,000`            | `144,000`           | `4,464,000`          |
| Business     | `60,000`           | `1,440,000`         | `44,640,000`         |
| Organization | `Custom`           | `Custom`            | `Custom`             |

Вызовы API учитываются по расходу, а это значит, что если у вас несколько пользователей в одном профиле (т. е. организации), количество вызовов API будет кратно числу пользовательских лицензий.

## Лимит запросов

Pubrio API имеет лимит запросов для обеспечения стабильности и надёжности сервиса. Используется фиксированное окно с ограничением 3000 запросов в минуту.

Это мягкий лимит, который может быть скорректирован в зависимости от вашего конкретного случая использования; пожалуйста, сообщите команде поддержки, если у вас есть особые требования. При превышении лимита запросов вы получите код ответа 429.

## Проверка использования

Вызовите [Profile Usage](/ru/api-reference/endpoint/profile/profile-usage), чтобы узнать текущее потребление и лимиты, не полагаясь на догадки по таблице выше.

| Поле                                                                                       | Значение                                                                                                         |
| ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| `api_hourly_usage` / `api_daily_usage` / `api_monthly_usage`                               | Количество вызовов API, использованных в текущем окне                                                            |
| `max_api_hourly_query` / `max_api_daily_query` / `max_api_monthly_query`                   | Лимит вашего плана на одну лицензию для каждого окна                                                             |
| `total_max_api_hourly_query` / `total_max_api_daily_query` / `total_max_api_monthly_query` | Лимит на лицензию, умноженный на количество ваших мест — лимит, который фактически применяется к рабочей области |
| `api_last_refreshed`                                                                       | Когда счётчики были последний раз обновлены                                                                      |

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

<Tip>
  Сравнивайте `api_monthly_usage` с `total_max_api_monthly_query`, а не с `max_api_monthly_query` — показатели с префиксом `total_` уже учитывают множитель лицензий, описанный выше.
</Tip>

## Лимиты плана

Каждый лимит, способный отклонить запрос, возвращается в [Profile](/ru/api-reference/endpoint/profile/profile) в разделе `subscription`. Ориентируйтесь на эти значения, а не задавайте их жёстко в коде — они различаются в зависимости от плана.

| Поле                                                                 | Регулирует                                                                                                                     |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `max_search_per_page`                                                | Максимально допустимое значение `per_page`. Превышение возвращает HTTP 416 (`41676`, либо `41613` при поиске компаний и людей) |
| `max_search_page`                                                    | Максимально допустимое значение `page` для большинства видов поиска                                                            |
| `max_company_search_page`                                            | Максимально допустимое значение `page` именно для поиска компаний                                                              |
| `max_display_search_page`                                            | Количество страниц, возвращаемое в `pagination.total_display_pages`                                                            |
| `max_company_search_select_limit` / `max_people_search_select_limit` | Максимальный `select_size` для массового выбора                                                                                |
| `max_export_limit` / `max_statistic_export_limit`                    | Лимит строк для экспорта                                                                                                       |
| `max_record_upload_size`                                             | Максимально допустимый размер загрузки                                                                                         |
| `max_expansion_window_days`                                          | Самый широкий диапазон дат для эндпоинтов экспансии (`null` = без ограничений)                                                 |
| `max_expansion_markets_preview`                                      | Количество рынков, возвращаемых до того, как `other_markets_locked_count` начнёт усечение (`null` = без ограничений)           |
| `max_expansion_comparison_peers`                                     | Количество аналогов, возвращаемых сравнением по экспансии (`null` = без ограничений)                                           |

<Warning>
  Превышение лимита — это **HTTP 416**, а не 400, и набор результатов никогда не обрезается незаметно — запрос завершается ошибкой полностью. См. [Коды состояния](/ru/api-reference/status-codes).
</Warning>