Limites e cotas
Cada plano tem uma cota de requisições, um limite de requisições por segundo e um tamanho máximo de página.
Planos
| Plano | Cota | Requisições / segundo | Tamanho máx. da página | Créditos |
|---|---|---|---|---|
| free | 100 no total | 1 | 10 | — |
| pro | 50.000 / mês | 10 | 100 | Pacotes de 25.000 requisições |
| business | 500.000 / mês | 50 | 100 | Pacotes de 25.000 requisições |
Preços e upgrades: /pricing. Créditos são requisições pré-pagas, gastas só depois que a cota mensal acaba; eles não expiram com a virada do mês.
O que conta
- Toda requisição autenticada que chega a um endpoint conta como uma, inclusive as que retornam 404.
- Não contam:
401,400por parâmetros inválidos,429e qualquer5xx(devolvida). GET /me/usagetambém conta — quando puder, leia os cabeçalhos de resposta das suas chamadas normais.- As cotas pagas renovam às 00:00 UTC do dia 1º de cada mês. A cota do Free nunca renova.
Cabeçalhos de resposta
Respostas bem-sucedidas informam sua situação (campos de cabeçalho RateLimit do IETF):
HTTP/1.1 200 OK
RateLimit-Limit: 50000
RateLimit-Remaining: 49231
RateLimit-Reset: 1036800
X-Quota-Remaining: 49231
X-Request-Id: 5f0c8d3e-4b7a-4f43-9a51-2a8c4f3f9b10| Cabeçalho | Significado |
|---|---|
RateLimit-Limit | Requisições no período atual (a cota do seu plano). |
RateLimit-Remaining | Requisições restantes antes do 402 (sem contar os créditos). |
RateLimit-Reset | Segundos até a cota renovar; 0 para a cota vitalícia do Free. |
X-Quota-Remaining | O mesmo que RateLimit-Remaining. |
Retry-After | Em 429 e 503: segundos a esperar antes de tentar de novo. |