Rate limit exceeded no Twitter: como resolver

#O que "rate limit exceeded" significa no X

"Rate limit exceeded" é o X avisando que você passou de um limite. Um rate limit é um teto de quantas vezes uma conta, um app ou um programa pode fazer uma coisa em uma janela de tempo definida, e o X mantém um para ler, publicar, seguir, enviar mensagens e para cada endpoint da sua API.

Qual limite você atingiu depende de onde a mensagem apareceu. No app do X ou em x.com, é um limite da sua própria conta. Numa ferramenta conectada ou num site leitor como o xcancel, é o acesso dessa ferramenta ao X. No seu próprio código, ela chega como HTTP 429, e o guia de códigos de erro da API do X explica a resposta inteira, horário de reinício incluído.

O X diz que os limites aliviam a carga dos seus sistemas e reduzem o tempo fora do ar, e que podem ser diminuídos para todos nos períodos de uso intenso do site. Os mesmos hábitos podem passar num dia calmo e estourar um limite num dia movimentado.

#Quanto dura um rate limit do Twitter

A maioria dos rate limits do X dura de 15 minutos a um dia, e a espera depende do limite que você atingiu: cada um corre no seu próprio relógio. As janelas por endpoint da API oficial do X reiniciam em até 15 minutos na maioria dos endpoints; os limites de posts da conta levam algumas horas, e os de mensagens e de contas seguidas levam um dia.

• Posts e respostas voltam em algumas horas: o X conta o limite diário em fatias de meia hora e pede que você tente de novo algumas horas depois.
• Mensagens diretas e contas seguidas voltam quando o limite do dia passa.
• Apps de terceiros dividem um limite por hora, então voltam a funcionar dentro de uma hora.
• As janelas da API oficial do X reabrem no horário Unix do cabeçalho x-rate-limit-reset: 15 minutos na maioria dos endpoints, 24 horas em alguns.
• O limite de leitura não tem nenhuma duração publicada.

O limite de leitura é o que a maioria das pessoas encontra ao rolar a tela, e o único que o X nunca colocou na sua página de limites (abre em uma nova aba). Em julho de 2023 o X limitou a leitura a 6.000 posts por dia para contas verificadas, 600 para as não verificadas e 300 para as novas, e chamou os limites de temporários, como noticiou a Reuters (abre em uma nova aba). Nenhum número atual foi publicado desde então, então uma página que cita um está chutando.

Bom saber

A página de limites do X lista 50 posts e 200 respostas por dia para contas não verificadas, mas um parágrafo mais abaixo ainda menciona 2.400 atualizações por dia. A lista é a regra atual: o X reduziu o limite em maio de 2026, como noticiou a PCMag (abre em uma nova aba). Os guias que citam 2.400 copiam a linha desatualizada.

#Como resolver "rate limit exceeded" no app do X

Para resolver "rate limit exceeded" no app do X ou em x.com, pare a ação que causou o bloqueio, feche o X e espere o tempo indicado acima. Nada do seu lado reinicia um limite de conta mais cedo.

1. Pare de atualizar. Cada recarga pede mais posts ao X e conta no mesmo limite.

2. Descubra a ação. Rolar a tela, publicar, seguir e enviar mensagens têm cada um o seu limite; o decodificador acima dá a espera de cada um.

3. Desconecte os apps que você não usa. Em Configurações e privacidade, abra Segurança e acesso à conta, depois Apps e sessões, e revogue as ferramentas de que você não precisa mais: todas dividem um mesmo limite de API por hora.

4. Veja se é com todo mundo. O X reduz os limites de todas as contas quando o site está sob carga alta e publica uma atualização no seu site de status. Se amigos veem a mesma mensagem, a espera é do X.

5. Tente uma vez. Depois da espera, faça uma ação e veja se ela passa antes de continuar.

Sair e entrar de novo, trocar de navegador ou de dispositivo, ou mudar de rede não reinicia um limite de conta. O X conta as ações da conta de todos os dispositivos e da API juntos, então uma sessão nova encontra o mesmo contador.

#Como resolver um erro 429 da API do X no seu código

Um 429 da API oficial do X significa um de dois limites, e só um deles passa em minutos, então leia o tipo do erro antes de dormir. A referência de erros (abre em uma nova aba) do X lista os dois sob o mesmo status: um rate limit ou um teto de uso.

O limite de janela é o comum. Cada endpoint permite um número definido de requisições a cada 15 minutos, ou a cada 24 horas em alguns, contado por app com um Bearer token e por usuário com tokens OAuth. Três cabeçalhos em toda resposta mostram onde você está: x-rate-limit-limit, x-rate-limit-remaining e x-rate-limit-reset, um horário Unix em segundos. Quando remaining chega a 0, toda chamada devolve 429 com o código de erro 88 até esse horário. Os números por endpoint estão no nosso guia de rate limits da API do X.

O teto de uso é mensal. O acesso de pagamento por uso para em 3 milhões de leituras de posts por ciclo de cobrança, e depois dele toda leitura devolve 429 com o tipo usage-capped até o ciclo terminar ou você passar para um contrato Enterprise, então tentar de novo no horário de reinício só gasta tentativas. Um limite de gastos definido no Developer Console bloqueia as requisições do mesmo jeito até o próximo ciclo, e um saldo de créditos zerado as bloqueia até você adicionar créditos.

Este tratador dorme até o reinício num limite de janela e para num teto de uso:

import time
import requests

def get_x(url, headers, params=None):
    while True:
        r = requests.get(url, headers=headers, params=params, timeout=30)
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()
        if "usage-capped" in r.text:
            raise RuntimeError("X usage cap: wait for the next billing cycle")
        reset = int(r.headers.get("x-rate-limit-reset", time.time() + 60))
        time.sleep(max(reset - time.time(), 1) + 1)

Espalhar as chamadas pela janela evita o próximo 429: a busca recente permite a um app 450 requisições a cada 15 minutos, então uma requisição a cada 2 segundos nunca chega ao limite. Se a mensagem diz que a sua requisição parece automatizada, isso não é um rate limit; esse erro tem causas próprias, explicadas em por que o X diz que uma requisição parece automatizada.

#Com rate limit depois de quase nada

Você pode ser limitado depois de poucas ações porque a contagem inclui mais do que os seus toques: apps trabalhando em segundo plano, serviços compartilhados e limites mais baixos do X nos dias de muito movimento.

• Apps conectados. Um agendador, uma ferramenta de análise e um rastreador de seguidores usam o mesmo limite de API por hora da sua conta, então juntos podem esgotá-lo enquanto você dorme.
• Leitores compartilhados. O xcancel e as instâncias do Nitter leem o X em nome de cada visitante. Quando um deles atinge os limites do X, todo mundo que o abre vê "rate limited", e a sua conta não tem nada a ver com isso.
• Timelines incorporadas. Uma timeline do X incorporada num site carrega pelo serviço de embed do X, que pode responder ao site com um 429 próprio.
• Dias movimentados. O X pode reduzir os limites de todos nos períodos de uso intenso, então uma sessão normal pode estourar um limite que passaria em outro dia.

Se nada disso se encaixa e os seus posts simplesmente deixaram de chegar às pessoas sem nenhuma mensagem, a causa não é um rate limit: veja a pergunta sobre shadowban no FAQ abaixo.

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

Para ler dados públicos do X por código, a Sorsa API, uma API e scraper do Twitter (X), tem um único limite em vez de janelas por endpoint: 20 requisições por segundo por chave de API (abre em uma nova aba), em todos os planos. Um 429 ali significa que mais de 20 chamadas chegaram em um segundo, e o segundo seguinte já funciona de novo.

Ela precisa de uma chave de API num cabeçalho ApiKey, sem conta de desenvolvedor do X e sem OAuth, e nunca pede o login do seu X, então a sua conta do X nunca corre risco; o nosso guia da API do Twitter sem conta de desenvolvedor mostra essa configuração. A Sorsa API lê apenas dados públicos e nunca publica; para publicar, combine-a com a API oficial do X.

Lado a lado, a Sorsa API reinicia a cada segundo e não tem teto de 3 milhões de leituras, enquanto a API oficial do X reinicia por endpoint e para em 3 milhões de leituras de posts por mês:

• Rate limit

  Sorsa API

  20 requisições por segundo por chave, em todos os planos

  API oficial do X

  Por endpoint, por app e por usuário, na maioria a cada 15 minutos

• Um 429 significa

  Sorsa API

  Mais de 20 requisições em um segundo

  API oficial do X

  Uma janela acabou, ou o teto de uso foi atingido

• Tentar de novo

  Sorsa API

  No segundo seguinte

  API oficial do X

  x-rate-limit-reset, ou o próximo ciclo de cobrança

• Teto mensal

  Sorsa API

  As requisições do seu plano, com requisições extras por cima

  API oficial do X

  3 milhões de leituras de posts, depois Enterprise a partir de cerca de US$ 42 mil por mês

• Preço por 1.000 posts

  Sorsa API

  A partir de US$ 0,014 por ID, a partir de US$ 0,07 por busca

  API oficial do X

  US$ 5,00

• Acesso

  Sorsa API

  Uma chave de API

  API oficial do X

  Conta de desenvolvedor e OAuth

A partir de 22 de novembro de 2026, a API oficial do X também cobra o autor que vem com cada post a US$ 0,010 por usuário (aviso do X (abre em uma nova aba)), enquanto todo tweet da Sorsa API traz o perfil completo do autor na mesma requisição. O resto da lista de preços do X está no nosso detalhamento dos preços da API do X.

1. Pegue uma chave. Cadastre-se e copie a sua chave de API no painel. As primeiras 100 requisições são grátis.

2. Busque em uma requisição. O POST /search-tweets (abre em uma nova aba) aceita qualquer consulta de busca do X e devolve cerca de 20 posts por página, com um next_cursor para a página seguinte.

   curl -X POST "https://api.sorsa.io/v3/search-tweets" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "from:ratelimit_fix_demo", "order": "latest"}'
   

   {
     "tweets": [
       {
         "id": "2117203385470271488",
         "full_text": "Paced reads, no 15-minute windows.",
         "created_at": "2026-11-02T10:41:07Z",
         "lang": "en",
         "likes_count": 12,
         "retweet_count": 3,
         "reply_count": 1,
         "view_count": 1840,
         "user": {
           "id": "1592041833471827968",
           "username": "ratelimit_fix_demo",
           "display_name": "Rate Limit Demo",
           "followers_count": 920
         }
       }
     ],
     "next_cursor": "DAACCgACG1x7rWyAJxAKAAMbXHutbH_YUwgABAAAAAEAAA"
   }
   

   Ver resposta completa

3. Pagine na velocidade máxima. Devolva o next_cursor até ele voltar vazio, faça uma pausa de um vigésimo de segundo entre as chamadas e trate um 429 como uma espera de um segundo.

   import time
   import requests
   
   URL = "https://api.sorsa.io/v3/search-tweets"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   
   def search_all(query, max_pages=100):
       body, tweets, pages = {"query": query, "order": "latest"}, [], 0
       while pages < max_pages:
           r = requests.post(URL, json=body, headers=HEADERS, timeout=30)
           if r.status_code == 429:  # over 20 requests in one second
               time.sleep(1)
               continue
           r.raise_for_status()  # 403: the key's requests ran out
           page = r.json()
           tweets += page.get("tweets", [])
           pages += 1
           if not page.get("next_cursor"):
               break
           body["next_cursor"] = page["next_cursor"]
           time.sleep(0.05)  # stays under 20 requests per second
       return tweets
   
   print(len(search_all("from:ratelimit_fix_demo")))
   

   const URL = "https://api.sorsa.io/v3/search-tweets";
   const HEADERS = { ApiKey: "YOUR_API_KEY", "Content-Type": "application/json" };
   const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
   
   async function searchAll(query, maxPages = 100) {
     const body = { query, order: "latest" };
     const tweets = [];
     for (let pages = 0; pages < maxPages; ) {
       const res = await fetch(URL, {
         method: "POST",
         headers: HEADERS,
         body: JSON.stringify(body),
       });
       if (res.status === 429) { await sleep(1000); continue; } // over 20 a second
       if (!res.ok) throw new Error(`HTTP ${res.status}`); // 403: out of requests
       const page = await res.json();
       tweets.push(...(page.tweets ?? []));
       pages += 1;
       if (!page.next_cursor) break;
       body.next_cursor = page.next_cursor;
       await sleep(50); // stays under 20 requests per second
     }
     return tweets;
   }
   
   searchAll("from:ratelimit_fix_demo").then((t) => console.log(t.length));
   

4. Acompanhe o seu saldo. O GET /key-usage-info (abre em uma nova aba) devolve as requisições restantes e a data em que renovam, e a própria consulta é grátis. Um 403 significa que as requisições da chave acabaram.

#Pare de esperar nas janelas de rate limit

"Rate limit exceeded" no X passa sozinho: em 15 minutos na maioria das janelas da API oficial do X, em algumas horas ou em um dia nos limites de conta, e só no próximo ciclo de cobrança no teto de 3 milhões de leituras de posts. Se você continua esbarrando nele porque o seu código lê dados do X, mude essas leituras para a Sorsa API: um único limite de 20 requisições por segundo por chave em todos os planos, posts a partir de US$ 0,014 por 1.000 e 100 requisições grátis para testar hoje.

#FAQ