Comece por aqui
Limites de uso
Acompanhe a cota diária e o limite por minuto para tratar respostas HTTP 429.
As requisições estão sujeitas a uma cota diária e a um limite por minuto. Se qualquer um deles for atingido, a API retorna HTTP 429.
Cota diária por plano
| Plano | Cota padrão | Compartilhamento |
|---|---|---|
| Pro | 1.000 requisições por dia | Entre os tokens da pessoa. |
| Business | 10.000 requisições por dia | Entre os tokens da empresa. |
A cota é renovada na virada do dia do serviço. Consulte o limite aplicado e o consumo atual em API > Cotas de hoje, no painel, ou nos cabeçalhos da resposta.
Requisições que chegam ao processamento do endpoint consomem a cota, mesmo quando retornam erros de validação, como 400, 404, 409, 413 ou 415. Recusas anteriores ao processamento, como token inválido, falta de autorização, método incorreto e limite já atingido, não consomem a cota diária.
Limite por minuto de cada token
O limite por minuto é aplicado separadamente a cada token e é o mesmo para os dois planos. Leia X-RateLimit-Limit para saber o limite vigente. Uma requisição pode consumir esse limite mesmo que depois seja recusada pelo endpoint.
Cabeçalhos para acompanhar o consumo
| Cabeçalho | Descrição |
|---|---|
X-Quota-Limit | Cota diária aplicada à pessoa ou à empresa. |
X-Quota-Remaining | Requisições restantes na cota diária. |
X-RateLimit-Limit | Limite por minuto do token. |
X-RateLimit-Remaining | Requisições restantes na janela atual de um minuto. |
Retry-After | Tempo de espera, em segundos, quando a resposta é 429. |
Os cabeçalhos de cota diária aparecem quando essa cota é verificada. Os de limite por minuto aparecem nas requisições que passam pela verificação do token. O Resumo da conta também informa o consumo diário e o limite por minuto no objeto api.
Como tratar HTTP 429
Leia Retry-After e aguarde o tempo indicado antes de tentar novamente. Para o limite por minuto, a espera informada é de 60 segundos. Para a cota diária, é o tempo restante até a renovação.
Planeje consultas em lote
Antes de um lote, consulte o consumo em Resumo da conta. Reaproveite resultados de listagem e estatísticas quando possível e siga o guia de Paginação e filtros para reduzir o número de requisições.