Limite de requisições

Existem dois tipos de limites — requisições de leitura (GET) e de escrita (POST, PUT, PATCH, DELETE) —, ambos por janela deslizante de 1 hora: cada requisição conta contra o limite pelos 60 minutos seguintes, não há um "zerar" em horário fixo.

Tipo	Limite
Leitura (GET)	60 requisições/hora
Escrita (POST, PUT, PATCH, DELETE)	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 quando a contagem libera:

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: 1784293200
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