Rate limits

O limite é aplicado por API Key, em janelas de 1 minuto.

Limite	Janela	Escopo
60 requisições	60 segundos	Por API Key

Headers de resposta

Toda resposta autenticada inclui:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1735689660

X-RateLimit-Reset é um timestamp Unix em segundos indicando quando a janela atual reinicia.

Quando o limite é excedido

HTTP/1.1 429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "Muitas requisições. Tente novamente em instantes.",
    "request_id": "..."
  }
}

Implemente retry com backoff exponencial e respeite X-RateLimit-Reset. Prefira paginar com limit=100 a fazer muitas chamadas pequenas.

A contagem é mantida em memória pelo runtime que atende a requisição. Em execução distribuída, o total efetivo pode ser levemente superior ao anunciado nos headers — trate os headers como orientação, não como um contador global exato.