> ## 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.

# Limite de taxa

> Limite de taxa para garantir a estabilidade e a confiabilidade.

## Total de requisições da API

O total de requisições da sua API é regido pelas especificidades do seu plano Pubrio atual. Para entender seus limites mensais de requisições, consulte os detalhes de preços da API da Pubrio.

A Pubrio utiliza uma abordagem de limite de taxa por janela fixa para as chamadas de API. Por exemplo,

| Assinatura   | Chamadas de API (por hora) | Chamadas de API (por dia) | Chamadas de API (por mês) |
| ------------ | -------------------------- | ------------------------- | ------------------------- |
| 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`                  |

As chamadas de API são baseadas em consumo, o que significa que, se você tiver vários usuários no mesmo perfil (ou seja, organização), as chamadas de API serão um múltiplo do número de licenças de usuário.

## Limite de taxa

A API Pubrio possui um limite de taxa para garantir a estabilidade e a confiabilidade do serviço. Ela tem um limite de taxa de janela fixa de 3.000 requisições por minuto.

Este é um limite flexível e pode ser ajustado de acordo com seu caso de uso específico; avise a equipe de suporte se tiver alguma necessidade particular. Ao exceder o limite de taxa, você receberá um código de resposta 429.

## Verificando seu uso

Chame [Profile Usage](/pt/api-reference/endpoint/profile/profile-usage) para consultar seu consumo atual e seus limites sem precisar deduzir a partir da tabela acima.

| Campo                                                                                      | Significado                                                                                               |
| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| `api_hourly_usage` / `api_daily_usage` / `api_monthly_usage`                               | Chamadas de API consumidas na janela atual                                                                |
| `max_api_hourly_query` / `max_api_daily_query` / `max_api_monthly_query`                   | O limite do seu plano por licença para cada janela                                                        |
| `total_max_api_hourly_query` / `total_max_api_daily_query` / `total_max_api_monthly_query` | O limite por licença multiplicado pelo número de assentos — o limite que realmente se aplica ao workspace |
| `api_last_refreshed`                                                                       | Quando os contadores foram atualizados pela última vez                                                    |

Os mesmos quatro grupos existem com o prefixo `portal_` para o uso do dashboard, que é medido separadamente do uso da API.

<Tip>
  Compare `api_monthly_usage` com `total_max_api_monthly_query`, não com `max_api_monthly_query` — os valores `total_` já consideram o multiplicador de licenças descrito acima.
</Tip>

## Limites do plano

Todo limite que pode rejeitar uma requisição é retornado por [Profile](/pt/api-reference/endpoint/profile/profile) em `subscription`. Consulte-os em vez de codificar valores fixos — eles variam de acordo com o plano.

| Campo                                                                | Rege                                                                                                       |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `max_search_per_page`                                                | O maior `per_page` aceito. Excedê-lo retorna HTTP 416 (`41676`, ou `41613` em busca de empresas e pessoas) |
| `max_search_page`                                                    | O maior `page` aceito na maioria das buscas                                                                |
| `max_company_search_page`                                            | O maior `page` aceito especificamente na busca de empresas                                                 |
| `max_display_search_page`                                            | Número de páginas retornado em `pagination.total_display_pages`                                            |
| `max_company_search_select_limit` / `max_people_search_select_limit` | O maior `select_size` para seleção em massa                                                                |
| `max_export_limit` / `max_statistic_export_limit`                    | Limite de linhas para exportações                                                                          |
| `max_record_upload_size`                                             | O maior upload aceito                                                                                      |
| `max_expansion_window_days`                                          | A janela de datas mais ampla nos endpoints de expansão (`null` = ilimitado)                                |
| `max_expansion_markets_preview`                                      | Mercados retornados antes de `other_markets_locked_count` truncar (`null` = ilimitado)                     |
| `max_expansion_comparison_peers`                                     | Pares retornados pela comparação de expansão (`null` = ilimitado)                                          |

<Warning>
  Uma violação de limite é **HTTP 416**, não 400, e o conjunto de resultados nunca é silenciosamente reduzido — a requisição falha completamente. Veja [Códigos de status](/pt/api-reference/status-codes).
</Warning>