Por plano
| Plano | Chamadas por mês | Limite por minuto |
|---|---|---|
| Bronze mensal | 5.000 | 20 |
| Bronze anual | 5.000 | 20 |
| Prata mensal | 12.500 | 40 |
| Prata anual | 12.500 | 40 |
| Ouro mensal | 50.000 | 60 |
| Ouro anual | 50.000 | 60 |
| Diamante mensal | 200.000 | 60 |
| Diamante anual | 200.000 | 60 |
| Black mensal | 500.000 | 80 |
| Black anual | 500.000 | 80 |
Preços e o que mais cada plano inclui estão em Planos.
O que conta como chamada
Cada requisição admitida conta 1 chamada, não importa quantas empresas voltem. Uma consulta de CNPJ é uma chamada; uma contagem agrupada por cidade também.
A requisição é admitida quando passa pelo token, pela conta, pelos limites por minuto e pela cota. A partir daí ela conta, mesmo que termine em erro:
- Contam: 404 de CNPJ fora da base, 400 de agrupamento ou de parâmetro do ranking, 403 de filtro recusado, 422 da contagem de obras e 503 de base em atualização.
- Podem contar: 500 e 503 de consulta demorada, conforme o ponto em que a falha acontece.
- Não contam: 401, 403 de conta sem acesso, 403 de cota esgotada, 400 de parâmetro desconhecido na contagem e 429.
Cada caso, com o corpo da resposta, está em Erros e retentativas.
O mês da cota
A cota conta por mês calendário, no horário de Brasília, e renova no primeiro dia do mês. Esgotada, as chamadas recebem 403 Monthly Quota Exceeded até o mês seguinte. Você vê o uso do mês e o limite em Configurações › Integrações › Tokens da API.
Limite por minuto
O limite por minuto do plano vale para a conta inteira, somando todos os tokens. Passou dele, a resposta é 429 Rate Limit Exceeded, sem cabeçalho dizendo quanto esperar. Contagem de empresas, ranking e contagem de obras têm ainda um limite próprio por minuto, que vale junto com o do plano (veja Limite das buscas).
MCP
Pelo MCP, buscar empresas, consultar uma empresa por CNPJ e gerar filtro usam a mesma cota mensal da API. As ferramentas de CRM, de conta e de códigos dos filtros não usam. Detalhes em MCP.
Boas práticas
- Controle o ritmo no seu lado para ficar abaixo do limite por minuto.
- Guarde respostas em cache quando fizer sentido. Uma chamada a menos é cota que sobra.
- Defina um timeout. Recomendamos 30 segundos.
- Repita só o que vale repetir, com espera crescente: veja Retentativas.
- Use circuit breaker: depois de várias falhas seguidas, pare de chamar por um tempo.
- Acompanhe o uso do mês em Tokens da API para não ser surpreendido por um 403.