Limite de requisições

Existem dois tipos de limites — requisições GET e requisições POST —, ambos contados por hora, com a contagem zerada no primeiro minuto de cada hora:

Tipo	Limite
GET	60 requisições/hora
POST	1000 requisições/hora

Caso sua operação precise de um número maior, fale com o suporte ou comercial.

Headers de resposta

A cada requisição, o servidor anexa aos cabeçalhos da resposta os limites utilizados e o tempo de espera até a próxima janela:

Header	Exemplo	Descrição
ratelimit-limit	60	Limite de requisições para o cliente.
ratelimit-name	throttle_v1_write	Nome do throttle utilizado.
ratelimit-remaining	0	Número de requisições disponíveis.
ratelimit-reset	1782648000	Unix time — quando a contagem reinicia.
retry-after	30	Segundos até a contagem reiniciar. Ver Retry-After.

Exemplo de resposta em sucesso

Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 486

Exemplo de resposta em bloqueio

Quando o limite é atingido, o servidor retorna HTTP 429 Too Many Requests. Aguarde o número de segundos do header retry-after antes da próxima requisição.

HTTP/1.1 429 Too Many Requests
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 0
ratelimit-reset: 3600
ratelimit-name: throttle_v1_write
retry-after: 3600

{ "error": { "code": "rate_limited", "message": "Write request rate limit exceeded for this token." } }

dica

Use limit=100 nas listagens e os filtros para reduzir o número de requisições — e trate 429 com backoff pelo retry-after, nunca com retry imediato.

Referência: RateLimit header fields for HTTP