Rate limits da API do Twitter (X) em 2026

#Rate limits da API do X por endpoint em 2026

Cada endpoint da API v2 do X tem o próprio limite, contado por app e por usuário, e a maioria reinicia a cada 15 minutos. Os números abaixo são os que o X publicou em 2 de novembro de 2026; o que cada chamada custa além do limite está na nossa análise dos preços da API do X.

As leituras permitem centenas ou milhares de requisições por janela, as gravações têm limite por usuário, e alguns endpoints acrescentam um limite de 24 horas ou de uma por segundo.

• Busca recente, últimos 7 dias (100)

  Por app

  450 / 15 min

  Por usuário

  300 / 15 min

• Busca em todo o arquivo, desde 2006 (500)

  Por app

  300 / 15 min e 1 / s

  Por usuário

  1 / s

• Posts por ID (100)

  Por app

  3.500 / 15 min

  Por usuário

  5.000 / 15 min

• Posts de uma conta (100)

  Por app

  10 mil / 15 min

  Por usuário

  900 / 15 min

• Menções a uma conta (100)

  Por app

  450 / 15 min

  Por usuário

  300 / 15 min

• Perfis por ID ou nome de usuário (100)

  Por app

  300 / 15 min

  Por usuário

  900 / 15 min

• Seguidores ou seguidos (1.000)

  Por app

  300 / 15 min

  Por usuário

  300 / 15 min

• Quem curtiu, repostou ou citou um post

  Por app

  75 / 15 min

  Por usuário

  75 / 15 min

• Criar um post ou resposta

  Por app

  10 mil / 24 h

  Por usuário

  100 / 15 min

• Excluir um post

  Por app

  nenhum

  Por usuário

  50 / 15 min

• Enviar uma mensagem direta

  Por app

  1.440 / 24 h

  Por usuário

  15 / 15 min e 1.440 / 24 h

Por app significa que toda requisição assinada com o Bearer token do seu app consome um contador compartilhado. Por usuário significa que cada usuário que autorizou o seu app por OAuth ganha um contador próprio, então o mesmo endpoint pode mostrar dois números, como 450 e 300 na busca recente. "Rate limits da API do X" e "rate limits da API do Twitter" são a mesma coisa: o X renomeou o produto, e os limites aqui são os da API v2 do X, a versão que a referência de rate limits dele cobre.

A tabela é um extrato datado. O X mantém a lista completa de mais de 100 endpoints, de Listas e Spaces ao upload de mídia, na referência de rate limits (abre em uma nova aba), e o Developer Console mostra os limites do seu próprio app.

Bom saber

A referência do X ainda lista limites para seguir, curtir e fazer quote posts, mas o X removeu essas gravações (abre em uma nova aba) de todos os planos self-serve em 20 de abril de 2026. No pagamento por uso, essas chamadas falham seja qual for a janela.

#Quanto tempo leva um job de leitura nesses limites

Em um app, a toda velocidade, as janelas do X permitem ler cerca de 600 mil posts por hora pela busca em todo o arquivo, 1,4 milhão por ID ou 1,2 milhão de seguidores. O pagamento por uso, porém, para em 3 milhões de posts lidos por mês e cobra cada um deles.

Cada valor por hora é a janela por app multiplicada pelo maior número de resultados que uma requisição devolve, em quatro janelas por hora: 300 buscas em todo o arquivo de 500 posts, 3.500 consultas de 100 posts, 300 páginas de seguidores de 1.000. A busca recente, com 450 requisições de 100 posts, chega a 180 mil posts por hora, só dos últimos 7 dias.

O limite mensal transforma esses números por hora em uma rajada curta. A toda velocidade, as consultas por ID chegam a 3 milhões de posts em cerca de 2 horas e a busca em todo o arquivo em cerca de 5, e 3 milhões de posts custam US$ 15.000 a US$ 0,005 por post do X. A partir de 22 de novembro de 2026, o X também cobra cada perfil de autor que você pede junto com um post pela tarifa de usuário de US$ 0,010 (abre em uma nova aba).

A Sorsa API, uma API e scraper do Twitter (X), tem um único limite: 20 requisições por segundo por chave de API, em todos os planos. Nesse limite, as mesmas tarefas rodam de 2,4 a 60 vezes mais rápido do que em um app da API oficial do X:

• Buscar posts

  Sorsa API, por hora

  cerca de 1,44 milhão, desde 2006

  API oficial do X, por hora (um app)

  600 mil pela busca em todo o arquivo, 180 mil pela busca recente

• Posts por ID

  Sorsa API, por hora

  7,2 milhões

  API oficial do X, por hora (um app)

  1,4 milhão

• Perfis

  Sorsa API, por hora

  7,2 milhões

  API oficial do X, por hora (um app)

  120 mil

• Seguidores

  Sorsa API, por hora

  14,4 milhões

  API oficial do X, por hora (um app)

  1,2 milhão

A diferença de preço é maior que a de velocidade. Os tweets custam a partir de US$ 0,014 por 1.000 na Sorsa API contra US$ 5,00 na API oficial do X, os seguidores a partir de US$ 0,007 contra US$ 10,00, e requisições com falha nunca são cobradas.

#Leia dados do X a 20 requisições por segundo

Para ler dados do X sem janelas de 15 minutos, use a Sorsa API: uma chave de API no header ApiKey, sem conta de desenvolvedor do X nem OAuth, e todo endpoint divide o mesmo limite de 20 requisições por segundo.

1. Obtenha uma chave. Cadastre-se e copie a sua chave de API no painel. As primeiras 100 requisições são grátis e leem até 10 mil tweets.

2. Leia 100 tweets em uma requisição. Envie até 100 links ou IDs de tweets para POST /tweet-info-bulk (abre em uma nova aba). Cada tweet volta com o perfil completo do autor, e o lote inteiro conta como uma requisição.

   curl -X POST \
     "https://api.sorsa.io/v3/tweet-info-bulk" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"tweet_links": ["1854021938471002113"]}'
   

   {
     "tweets": [
       {
         "id": "1854021938471002113",
         "full_text": "Weekly digest is out: 48 links, 3 charts.",
         "created_at": "2026-10-30T09:12:44Z",
         "lang": "en",
         "likes_count": 96,
         "retweet_count": 14,
         "reply_count": 9,
         "view_count": 8840,
         "user": {
           "id": "1590087714360229888",
           "username": "ratelimit_lab_demo",
           "display_name": "Rate Limit Lab",
           "followers_count": 2310
         }
       }
     ]
   }
   

   Ver resposta completa

3. Dê o ritmo de um job grande a 20 por segundo. A função envia lotes em rodadas de 20, uma rodada por segundo, então uma lista de um milhão de IDs roda no limite máximo sem nenhuma janela para esperar.

   import time
   from concurrent.futures import ThreadPoolExecutor
   
   import requests
   
   URL = "https://api.sorsa.io/v3/tweet-info-bulk"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   RATE = 20  # requests per second, per API key
   
   
   def fetch(batch):
       for _ in range(5):
           r = requests.post(URL, headers=HEADERS,
                             json={"tweet_links": batch}, timeout=30)
           if r.status_code == 429:  # over 20 in this second
               time.sleep(1)
               continue
           r.raise_for_status()
           return r.json()["tweets"]
       raise RuntimeError("still 429 after 5 tries")
   
   
   def read_tweets(ids):
       batches = [ids[i:i + 100] for i in range(0, len(ids), 100)]
       tweets = []
       with ThreadPoolExecutor(max_workers=RATE) as pool:
           for i in range(0, len(batches), RATE):
               started = time.monotonic()
               for page in pool.map(fetch, batches[i:i + RATE]):
                   tweets += page
               time.sleep(max(0, 1 - (time.monotonic() - started)))
       return tweets
   

4. Escolha o endpoint para o job. O mesmo limite vale para todos os endpoints, então só muda o número de resultados por requisição.

• O POST /search-tweets (abre em uma nova aba) aceita os operadores de busca do X, desde 2006, cerca de 20 tweets por página com next_cursor para a próxima.
• O GET /followers (abre em uma nova aba) devolve até 200 seguidores por página.
• O GET /info-batch (abre em uma nova aba) devolve até 100 perfis por nome de usuário ou ID de usuário.

O limite reinicia a cada segundo, não a cada 15 minutos, e a Sorsa API não envia headers de rate limit porque não há janela para acompanhar. Um 429 significa mais de 20 requisições em um segundo: espere um segundo e envie de novo, como descrevem os documentos de rate limits (abre em uma nova aba). Um 401 ou 403 significa que a chave está errada, ausente ou sem requisições. Como a Sorsa API se compara a todas as outras formas de ler dados do X está no nosso guia de alternativas à API do Twitter.

#Como funcionam as janelas, os headers e os 429 da API do X

Uma janela da API do X é um contador por endpoint que começa com a sua primeira requisição: cada chamada consome uma unidade e, no zero, o X responde 429 Too Many Requests até a janela se renovar.

Toda resposta informa em que ponto está o contador por meio de três headers:

x-rate-limit-limit: 450
x-rate-limit-remaining: 0
x-rate-limit-reset: 1793606400

O x-rate-limit-limit é o tamanho da janela e o x-rate-limit-remaining é o que resta. O x-rate-limit-reset é o momento em que a janela se renova, em segundos Unix e não em contagem regressiva. Leia-os em toda resposta: uma chamada que volta com 0 restante já avisou que a próxima vai falhar.

Acima de um limite, o X responde 429 com o código de erro 88, "Rate limit exceeded" (limite de requisições excedido). Esperar até o horário de reinício é a solução; tentar antes só junta mais 429. As correções passo a passo, o código de retentativa e a mensagem "rate limit exceeded" no app do X estão no nosso guia de rate limit exceeded no Twitter.

Um job que fica abaixo de todas as janelas ainda pode parar, porque a API oficial do X tem três camadas de limites, e cada uma encerra o job do seu jeito.

• As janelas por endpoint reiniciam sozinhas, após 15 minutos ou 24 horas, e a busca em todo o arquivo também recusa uma segunda requisição dentro do mesmo segundo.
• O limite mensal e os seus créditos não reiniciam com o tempo: o pagamento por uso para em 3 milhões de posts lidos por ciclo de cobrança, e as requisições são bloqueadas quando o saldo de créditos ou o limite de gastos que você definiu (abre em uma nova aba) acaba.
• Os limites de conta pertencem à conta do X, não ao app: eles contam posts, respostas, follows e mensagens do app do X, da web e da API em conjunto.

#Limites de publicação no X: por 15 minutos e por dia

Publicar pela API oficial do X tem dois tetos: o do endpoint, de 100 posts por usuário a cada 15 minutos e 10 mil por app por dia, e o da conta do X. Uma conta não verificada pode publicar só 50 posts originais e 200 respostas por dia, seja qual for a forma de envio.

O limite da conta é o que vale primeiro. A 100 posts por 15 minutos, o endpoint permitiria 9.600 posts por dia para um usuário, mas uma conta não verificada para em 50.

• Post original

  Limite da API oficial do X

  100 / 15 min por usuário, 10 mil / 24 h por app

  Limite da conta do X, todos os apps juntos

  50 por dia, contas não verificadas

• Resposta

  Limite da API oficial do X

  o mesmo endpoint de um post

  Limite da conta do X, todos os apps juntos

  200 por dia, contas não verificadas

• Excluir um post

  Limite da API oficial do X

  50 / 15 min por usuário

  Limite da conta do X, todos os apps juntos

  nenhum publicado

• Repost

  Limite da API oficial do X

  50 / 15 min por usuário

  Limite da conta do X, todos os apps juntos

  nenhum publicado

• Mensagem direta

  Limite da API oficial do X

  15 / 15 min e 1.440 / 24 h por usuário

  Limite da conta do X, todos os apps juntos

  500 por dia

• Seguir

  Limite da API oficial do X

  removido do self-serve em 20 de abril de 2026

  Limite da conta do X, todos os apps juntos

  400 por dia

• Curtir ou fazer quote post

  Limite da API oficial do X

  removido do self-serve em 20 de abril de 2026

  Limite da conta do X, todos os apps juntos

  nenhum publicado

A página de limites (abre em uma nova aba) do X diz que os limites de conta contam ações "de todos os dispositivos, incluindo web, celular, telefone, API", então um script e uma pessoa digitando no app consomem os mesmos 50 posts. O X divide o limite diário de posts em limites de meia em meia hora que não divulga, e, quando uma conta segue 5.000 outras, novos follows passam a depender das proporções da conta.

O limite de 50 posts é recente. O X o reduziu de 2.400 atualizações por dia em maio de 2026, como noticiou a PCMag (abre em uma nova aba), e a mesma página de ajuda ainda cita 2.400 em outro parágrafo. O X não divulga um número diário para contas verificadas. Cada post também custa dinheiro no pagamento por uso: US$ 0,015 por post e US$ 0,20 por um post com link.

A Sorsa API é somente leitura por princípio: ela nunca posta, curte, segue nem envia mensagens, e nunca pede o seu login do X nem cookies, então a sua conta do X não corre nenhum risco por causa dela. Para publicar, combine-a com a API oficial do X e deixe a leitura, como conferir se um post foi ao ar ou coletar suas respostas e menções, na Sorsa API.

#Rate limits do plano gratuito e do Enterprise

A API oficial do X não tem plano gratuito em 2026, então também não tem rate limits gratuitos. O plano Free dela, só de publicação, com limite final de 17 posts por 24 horas (abre em uma nova aba), foi encerrado para novos desenvolvedores em 6 de fevereiro de 2026, quando o pagamento por uso virou o padrão. O que ele permitia, ano a ano, está na nossa resposta a a API do Twitter é grátis?.

Os planos pagos Basic e Pro seguiram o mesmo caminho: o X migrou os assinantes do Basic para o pagamento por uso depois de 1º de junho de 2026 e os do Pro depois de 1º de setembro. As respostas de fóruns que citam os 100 posts por dia do Basic descrevem planos que ninguém pode comprar hoje. Todos que estão no pagamento por uso agora dividem as janelas da primeira tabela.

O Enterprise é a única forma de mudá-las. Os contratos Enterprise definem rate limits personalizados por acordo e eliminam o limite de 3 milhões de posts lidos; o X os vende por um formulário de interesse e não divulga preço, e, quando lançou o acesso Enterprise em 2023, os contratos foram noticiados a partir de US$ 42.000 por mês (abre em uma nova aba).

#Planeje um job de dados do X em torno de um único limite

Os rate limits da API do X são por endpoint e, em geral, por 15 minutos, com um limite mensal de 3 milhões de posts lidos e os limites diários da conta por cima, então um job grande precisa caber em três camadas ao mesmo tempo. Para ler dados do X em escala, use a Sorsa API: um único limite de 20 requisições por segundo por chave, até 100 tweets ou 200 seguidores por requisição, a partir de US$ 0,014 por 1.000 tweets. Comece com 100 requisições grátis, o suficiente para os seus primeiros 10 mil tweets.

#Perguntas frequentes