Limites de taxa
Como limitamos a taxa
O limite de taxa é por conta, medido em requisições por segundo (QPS). O teto depende apenas de você já ter comprado créditos alguma vez, com um pequeno aumento nos dois planos de assinatura mais altos.
Não há teto mensal nem diário — você pode consumir qualquer quantidade de créditos por mês, desde que fique abaixo do teto por segundo.
As assinaturas de Stream (monitoramento de contas) são separadas da API REST. Um plano de stream não inclui créditos de API nem um limite de taxa REST mais alto: as chamadas REST são pagas com créditos e, até você comprar créditos, sua conta permanece no limite gratuito de uma requisição a cada 5 segundos.
Limites reais
| Estado da conta | Limite de taxa |
|---|---|
Conta nova (nunca pagou) 0,2 req/s — suficiente para testar a API e incentiva a primeira recarga. | 1 requisição / 5 segundos |
Qualquer conta que já tenha comprado créditos pelo menos uma vez Basta uma única compra de créditos; nenhuma assinatura necessária. | 20 req/s |
Assinaturas Starter · Builder · Pro Esses planos competem em créditos, bônus e devolução de créditos, não em taxa de transferência. Precisa de mais QPS sustentado? Veja Scale e Business abaixo. | 20 req/s |
Assinatura Scale | 50 req/s |
Assinatura Business | 500 req/s |
Necessidades maiores Envie um e-mail para contact@twitterapi.io com seu caso de uso e os req/s sustentados esperados. | Sob demanda |
Escolhendo um plano? Veja /subscribe — Starter, Builder e Pro diferem em créditos concedidos, porcentagem de bônus na recarga e devolução contínua de créditos. Se você precisa de mais de 20 req/s de forma sustentada, Scale (50 req/s) e Business (500 req/s) são os planos onde o teto sobe.
Tráfego em rajadas? Ao bater no teto, você recebe HTTP 429 (não enviamos o cabeçalho Retry-After). Espere cerca de um segundo e tente de novo com backoff exponencial — não bloqueamos a conta.