Recursos
Limites e cotas
Rate limits, tamanho de payload, timeouts e outros limites operacionais da API.
Limites públicos formais ainda não estão definidos. Esta página documenta os limites internos atuais — eles podem mudar sem aviso enquanto a API estiver em Beta.
Limites por requisição
| Limite | Valor | Comportamento ao exceder |
|---|---|---|
| Tamanho da query string | 8 KB | 414 URI Too Long |
| Tempo de resposta máximo | 15 segundos | 504 Gateway Timeout |
limit máximo por página | 100 | 400 Bad Request |
| Termos por busca | 10 | Termos excedentes são ignorados |
| Tamanho do termo individual | 200 chars | Truncado silenciosamente |
messages_limit máximo | 20 | 400 Bad Request |
Rate limits
Hoje não há rate limit público documentado. Internamente aplicamos limites para proteger a infraestrutura:
- Por API key: aproximadamente 60 requisições por minuto em condições normais
- Por organização: limite agregado mais permissivo
Quando exceder, a resposta é 429 Too Many Requests com header Retry-After indicando segundos a esperar.
Veja Erros e retry para estratégia de tratamento.
Concorrência
Não impomos limite estrito de requisições concorrentes por chave, mas requisições paralelas excessivas podem disparar rate limit. Padrão recomendado: até 10 conexões simultâneas por chave.
Tamanho do payload de resposta
- Resposta típica de busca: 50-500 KB
- Máximo prático: ~2 MB (com
limit=100emessages_limit=20) - Compressão: gzip habilitado por padrão (envie
Accept-Encoding: gzip)
Próximos passos
- Rate limits formais documentados — sob avaliação