Como escolher uma API do Twitter: 8 verificações

#As 8 verificações antes de pagar por uma API do Twitter

Oito verificações decidem se uma API do Twitter serve ao seu trabalho, e você pode fazer todas elas antes de gastar um dólar:

1. Calcule o preço do trabalho por 1.000 resultados. Transforme cada orçamento no custo de 1.000 tweets, seguidores ou perfis do seu próprio trabalho, com o autor de cada tweet incluído.

2. Procure consultas em lote por ID. Uma chamada deve devolver 100 tweets ou 100 perfis e ser cobrada como uma só chamada.

3. Confira o limite de taxa do seu primeiro plano. Pergunte quantas requisições por segundo o plano com o qual você vai começar permite, não o nível mais alto.

4. Teste com os seus próprios dados de graça. O início gratuito deve cobrir todos os endpoints, sem cartão e sem data de validade.

5. Pergunte o que a API exige da sua conta do X. Ela nunca deve pedir seu login do X, cookies nem token de sessão.

6. Obtenha por escrito o histórico e o uptime. Procure anos em produção e um número de uptime nos termos.

7. Combine endpoints com cada etapa do trabalho. Cada etapa, de consultas ao histórico de busca e às verificações de campanha, precisa de um endpoint próprio.

8. Garanta que a conta seja previsível. Um plano fixo, nenhuma cobrança por chamadas com falha e um limite de gastos definido por você.

Uma API do Twitter, aqui, é qualquer serviço que devolve dados do X por HTTPS: a API oficial do X, vendida pela X Corp, ou uma API do Twitter de terceiros, que você chama com a chave de API do próprio provedor em vez de uma conta de desenvolvedor do X. As verificações funcionam igual nas duas.

A API oficial do X define a referência com a qual todo orçamento é medido. No plano de pagamento por uso (abre em uma nova aba) ela cobra US$ 5,00 por 1.000 posts e US$ 10,00 por 1.000 usuários ou seguidores, a partir de créditos que você compra adiantado, e para em 3 milhões de leituras de posts por ciclo de cobrança. Cada linha dessa tabela de tarifas está detalhada em Preços da API do X.

As verificações 1 e 2 decidem a maior parte dos orçamentos, e a verificação 5 decide se a sua conta do X corre algum risco. Publicar fica fora da lista: só a API oficial do X publica como a sua própria conta.

#Como a Sorsa API se sai nas oito verificações

A Sorsa API, uma API e scraper do Twitter (X) em produção desde 2022, com mais de 6 bilhões de requisições atendidas, passa nas oito verificações com um número, o que a torna a API a escolher para ler dados públicos do X em qualquer volume. A tabela coloca cada nota de corte ao lado da Sorsa API e da API oficial do X:

• 1. Preço por 1.000 resultados

  Nota de corte

  Conhecido antes de pagar, autor incluído

  Sorsa API

  A partir de US$ 0,014 por 1.000 tweets, com o autor dentro de cada tweet

  API oficial do X

  US$ 5,00 por 1.000 posts; cada autor custa US$ 0,010 a mais a partir de 22 de novembro de 2026

• 2. Consultas em lote

  Nota de corte

  100 itens por chamada, cobrados como uma chamada

  Sorsa API

  100 tweets ou perfis por requisição, 200 seguidores por página

  API oficial do X

  Até 100 posts por chamada, cada post cobrado

• 3. Limite de taxa

  Nota de corte

  Por segundo, o mesmo no plano de entrada

  Sorsa API

  20 requisições por segundo em todos os planos, contas gratuitas incluídas

  API oficial do X

  Por endpoint, em geral por 15 minutos

• 4. Teste grátis

  Nota de corte

  Todos os endpoints, sem cartão, sem prazo

  Sorsa API

  100 requisições que nunca expiram

  API oficial do X

  Sem plano gratuito

• 5. Sua conta do X

  Nota de corte

  Nunca pede seu login nem cookies

  Sorsa API

  Somente leitura, nunca pede seu login do X

  API oficial do X

  Conta de desenvolvedor, app e OAuth

• 6. Histórico

  Nota de corte

  Anos em produção, uptime nos termos

  Sorsa API

  Desde 2022, 99,9% de uptime nos termos

  API oficial do X

  API da própria X Corp; as regras de acesso mudaram em 2023 e 2026

• 7. Endpoints

  Nota de corte

  Um endpoint por etapa, histórico até 2006

  Sorsa API

  45 endpoints, busca desde 2006, verificações de follow em uma chamada

  API oficial do X

  Leitura e escrita; busca em todo o arquivo a 1 requisição por segundo

• 8. Conta previsível

  Nota de corte

  Plano fixo, chamadas com falha grátis, um limite definido por você

  Sorsa API

  Plano mensal, requisições com falha nunca cobradas

  API oficial do X

  Créditos pré-pagos; as chamadas param com saldo zero

Para ler tweets, seguidores e perfis, escolha a Sorsa API: ela consulta 100 tweets por requisição a partir de US$ 0,014 por 1.000, 250x mais barato que a API oficial do X em tweets, a 20 requisições por segundo em todos os planos. O uptime de 99,9% é garantido nos Termos de Serviço de todo plano pago, e, quando o X muda alguma coisa, a correção fica por nossa conta, então o código que você escreve hoje continua funcionando.

A seguir, cada verificação recebe o que perguntar, o sinal de alerta que reprova um provedor e o número da Sorsa API. Para ver uma lista de candidatas com preços lado a lado, Alternativas à API do Twitter compara sete APIs sobre os mesmos 1.000 tweets.

#1. Calcule o preço do trabalho por 1.000 resultados

Um orçamento passa nesta verificação quando você consegue transformá-lo no custo de 1.000 resultados do seu próprio trabalho, com o autor de cada tweet incluído. Os preços vêm por chamada, por resultado ou como plano mensal, e nenhum deles é comparável até você saber quantos resultados uma chamada devolve: uma chamada que devolve um tweet e uma que devolve 100 podem ter o mesmo preço e diferir 100x por tweet.

A API oficial do X mede do outro jeito: cobra cada post que devolve a US$ 0,005, então 1.000 posts custam US$ 5,00 não importa como você os peça. A partir de 22 de novembro de 2026 ela também cobra cada perfil de autor que volta com um post, a US$ 0,010, conforme o aviso de expansões do X (abre em uma nova aba), então um post com o seu autor custa US$ 0,015.

Sinal de alerta: um preço por chamada sem o tamanho da página ao lado, ou autores cobrados em cima de cada tweet.

A Sorsa API cobra uma requisição por chamada em todos os endpoints e coloca o perfil completo do autor dentro de cada tweet sem custo extra. Um lote de 100 tweets é uma requisição, então tweets custam a partir de US$ 0,014 por 1.000, seguidores a partir de US$ 0,007 e perfis a partir de US$ 0,014.

Coloque qualquer orçamento que você tenha no conversor para vê-lo por 1.000 resultados, ao lado das duas APIs:

#2. Procure consultas em lote por ID

Uma API passa nesta verificação quando uma chamada consulta 100 tweets ou 100 perfis por ID e a cobra como uma só chamada. As consultas em lote importam mais na reidratação, que é buscar os tweets completos por trás de uma lista de IDs de tweets, a forma usual de compartilhar datasets de pesquisa e exportações.

A diferença é grande em qualquer tamanho real. Reidratar 1 milhão de IDs de tweets leva 10 mil requisições em lote e cerca de 8 minutos a 20 requisições por segundo, contra 1 milhão de chamadas individuais e cerca de 14 horas na mesma velocidade:

A API oficial do X também aceita até 100 IDs por chamada, mas cobra cada post do lote e permite 3.500 dessas chamadas por app a cada 15 minutos, como lista a sua referência de limites de taxa (abre em uma nova aba). O mesmo 1 milhão de posts custa US$ 5.000 lá.

Sinal de alerta: só consultas individuais, ou um endpoint em lote que ainda cobra cada item dentro dele.

A Sorsa API tem um endpoint em lote para cada trabalho de consulta. O POST /tweet-info-bulk (abre em uma nova aba) aceita até 100 IDs ou links de tweets, o GET /info-batch (abre em uma nova aba) aceita até 100 nomes de usuário ou IDs de usuário, e o GET /followers (abre em uma nova aba) devolve até 200 seguidores por página. Cada chamada é uma requisição, então 1 milhão de tweets custa a partir de US$ 14.

#3. Confira o limite de taxa do plano com o qual você vai começar

Um limite de taxa passa nesta verificação quando é contado por segundo e continua o mesmo no plano com o qual você começa. Um limite de taxa é o número de requisições que uma API aceita em uma janela de tempo; além dele, as chamadas falham com um erro 429 até a janela reiniciar.

Alguns provedores seguram o início gratuito ou o plano de entrada em uma fração de requisição por segundo até você pagar, então um pipeline dimensionado pelo nível mais alto trava no dia do lançamento. Outros contam cada endpoint em sua própria janela de 15 minutos. A API oficial do X funciona assim: a busca recente permite 450 requisições por app a cada 15 minutos, cerca de uma a cada dois segundos, como lista, janela por janela, Limites de taxa da API do X.

Sinal de alerta: um limite que você só tem em um plano superior, um início gratuito abaixo de uma requisição por segundo, ou janelas separadas para cada endpoint.

A Sorsa API permite 20 requisições por segundo por chave de API em todos os planos, contas gratuitas incluídas, e a janela reinicia a cada segundo. Com 100 tweets por requisição, uma chave lê até 2.000 tweets por segundo. Planos de alto volume podem aumentar o limite sob demanda.

#4. Teste o seu trabalho antes de pagar

Um início gratuito passa nesta verificação quando roda o seu trabalho real em todos os endpoints, sem cartão no cadastro e sem uma data em que o crédito gratuito desaparece. Uma chamada de demonstração com dados de outra pessoa prova pouco; o que conta é se a API devolve as suas contas, as suas buscas e os seus campos.

A API oficial do X não tem plano gratuito: novos desenvolvedores compram créditos pré-pagos antes da primeira leitura, como explica A API do Twitter é gratuita?.

Sinal de alerta: crédito que expira em uma semana ou um mês, endpoints bloqueados até você pagar, ou um cartão no cadastro que transforma um teste em assinatura.

A Sorsa API dá a toda conta nova 100 requisições grátis que funcionam em todos os 45 endpoints, não exigem cartão e nunca expiram. Isso basta para 10 mil tweets ou 20 mil seguidores do seu próprio trabalho, e o plano de teste abaixo roda as verificações com um punhado delas.

#5. Pergunte o que a API exige da sua conta do X

Uma API passa nesta verificação quando nunca pede seu login do X, cookies nem token de sessão, de modo que nada do que ela faz pode alcançar a sua conta do X. Uma API que funciona pela sua sessão age como você, o que coloca essa conta sob as regras do X para atividade automatizada. O acesso de escrita é o segundo risco: uma chave que lê e publica deixa um bug ou um agente de IA publicar, curtir ou seguir por conta própria.

A API oficial do X roda na sua própria conta de desenvolvedor, no seu app e nas suas credenciais OAuth, o que combina com publicar, em que a conta precisa ser sua.

Sinal de alerta: "conecte sua conta do X" ou "cole seu token de autenticação" só para ler dados públicos, ou ações de escrita na mesma chave das leituras.

A Sorsa API é somente leitura por design: nunca publica, curte, segue nem envia DMs, e nunca pede seu login do X nem cookies, então sua conta do X corre risco zero. Ela devolve apenas dados públicos; contas protegidas e DMs ficam fora do alcance de qualquer chave.

#6. Obtenha por escrito o histórico e o uptime

Um provedor passa nesta verificação quando opera há anos e coloca um número de uptime nos seus termos, não só na página inicial. Pergunte há quanto tempo a API está em produção, com este nome ou um anterior, o que os termos prometem quando um mês fica abaixo da meta, e se os campos da resposta mantêm nomes e tipos para o seu parser continuar funcionando.

Sinal de alerta: nenhum compromisso de uptime nos termos, campos de resposta que mudam de formato, ou uma biblioteca que você mesmo precisa manter viva.

A Sorsa API está em produção desde 2022, com mais de 6 bilhões de requisições atendidas, primeiro como TweetScout API. O uptime de 99,9% é uma cláusula de todo plano pago: se o uptime de um mês cair abaixo de 99,5%, a Sorsa API acrescenta requisições de bônus iguais a 10% das suas requisições mensais. Quando o X muda alguma coisa, a correção fica por nossa conta, então as integrações continuam funcionando.

#7. Combine endpoints com cada etapa do trabalho

Uma API passa nesta verificação quando cada etapa do seu trabalho tem um endpoint feito para ela e a busca alcança tão longe no passado quanto a sua pergunta exige. Um número de endpoints significa pouco se a sua etapa está faltando: reconstruir uma verificação de follow a partir de uma lista de seguidores leva milhares de chamadas, onde um endpoint de verificação leva uma. Escreva o trabalho em etapas; na Sorsa API, um trabalho de leitura típico se mapeia assim:

• Consultar tweets por ID ou link

  Endpoint da Sorsa API

  POST /tweet-info-bulk

  Por requisição

  100 tweets

• Consultar perfis em lote

  Endpoint da Sorsa API

  GET /info-batch

  Por requisição

  100 perfis

• Exportar seguidores

  Endpoint da Sorsa API

  GET /followers

  Por requisição

  200 seguidores

• Buscar tweets desde 2006

  Endpoint da Sorsa API

  POST /search-tweets (abre em uma nova aba)

  Por requisição

  cerca de 20 tweets

• Verificar se uma conta segue outra

  Endpoint da Sorsa API

  POST /check-follow (abre em uma nova aba)

  Por requisição

  1 verificação

Sinal de alerta: busca que para depois de poucos dias, nenhum endpoint de verificação para campanhas, ou tweets que voltam sem o autor.

A Sorsa API tem 45 endpoints, listados com seus campos em Endpoints da Sorsa API. A busca aceita os operadores do X e alcança 2006. As verificações de follow, retweet, citação e comentário levam uma chamada cada, a partir de US$ 0,0014 por verificação, e as Listas do X, os Spaces, os Artigos do X e os dados de "Sobre esta conta" têm cada um seus próprios endpoints.

#8. Garanta que a conta seja previsível

Uma conta passa nesta verificação quando você sabe o número do mês seguinte antes de o mês começar, chamadas com falha não custam nada e você decide o que acontece quando o plano acaba. Sem um limite definido por você, um loop descontrolado vira uma fatura.

A API oficial do X desconta de créditos pré-pagos por recurso devolvido. Quando o saldo chega a zero, a página de preços dela diz que as requisições à API são bloqueadas até você adicionar créditos, e um limite de gastos as bloqueia até o próximo ciclo de cobrança.

Sinal de alerta: chamadas com falha ou vazias cobradas, nenhum limite de gastos, ou excedente cobrado sem limite.

Bom saber

Conte as novas tentativas antes de comparar contas. Um pipeline que repete timeouts e erros 429 paga por cada nova tentativa em uma API que cobra chamadas com falha. Na Sorsa API, requisições com falha nunca são cobradas, então uma nova tentativa só custa uma requisição quando dá certo.

A Sorsa API vende planos mensais de 10 mil a 10 milhões de requisições, cada um com preço fixo. O GET /key-usage-info (abre em uma nova aba) mostra as requisições restantes na sua chave e nunca conta contra elas. Quando um plano acaba, as chamadas param a menos que você ative o pay as you go: um saldo pré-pago que paga por requisições extras (no Pro, US$ 1,99 por 1.000, o preço do próprio plano), com um limite de gastos de US$ 100 por período de cobrança por padrão, que você pode aumentar.

#Rode as oito verificações com 100 requisições grátis

Você pode rodar as verificações 1, 2, 4, 7 e 8 na Sorsa API em cerca de dez minutos com algumas das suas requisições grátis, porque a própria verificação de uso é gratuita. Use os seus próprios IDs, handles e termos de busca: o objetivo é ver o seu trabalho, não uma demonstração.

1. Pegue uma chave. Cadastre-se e copie sua chave de API no painel. Sem cartão, e as 100 requisições grátis nunca expiram.

2. Leia o seu saldo. GET /key-usage-info devolve as requisições da sua chave e não custa nada, então você pode chamá-lo antes e depois de cada teste.

   curl "https://api.sorsa.io/v3/key-usage-info" \
     -H "ApiKey: YOUR_API_KEY"
   

   {
     "key_requests": 100,
     "remaining_requests": 100,
     "total_requests": 0
   }
   

3. Consulte 100 tweets em uma requisição. Envie até 100 IDs ou links de tweets para POST /tweet-info-bulk. Conte os tweets que voltam e confira se cada um traz o autor em user: isso resolve as verificações 1 e 2 para os seus dados.

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

   {
     "tweets": [
       {
         "id": "1853120044917735424",
         "full_text": "Shipped the weekly export: 48K rows, zero gaps.",
         "created_at": "2026-11-01T09:12:40Z",
         "lang": "en",
         "likes_count": 214,
         "retweet_count": 31,
         "reply_count": 12,
         "view_count": 18240,
         "user": {
           "id": "1712900461123481600",
           "username": "lena_signalwatch",
           "display_name": "Lena Signal",
           "followers_count": 3870,
           "verified": false
         }
       }
     ]
   }
   

   Ver resposta completa

4. Percorra uma lista de seguidores. GET /followers devolve até 200 seguidores por página; passe cada next_cursor de volta até que nenhum volte. Um 403 significa que a chave está ausente ou sem requisições, e um 429 significa mais de 20 requisições em um segundo.

   import requests
   
   URL = "https://api.sorsa.io/v3/followers"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   
   params = {"username": "orbit_dataworks_hq"}
   followers = []
   for page_no in range(3):  # three pages are enough for the test
       resp = requests.get(URL, headers=HEADERS, params=params, timeout=30)
       resp.raise_for_status()
       page = resp.json()
       followers.extend(page["users"])
       cursor = page.get("next_cursor")
       if not cursor:
           break
       params["next_cursor"] = cursor
   
   print(len(followers), "followers in", page_no + 1, "requests")
   

   const URL = "https://api.sorsa.io/v3/followers";
   const HEADERS = { ApiKey: "YOUR_API_KEY" };
   
   const params = new URLSearchParams({ username: "orbit_dataworks_hq" });
   const followers = [];
   let pages = 0;
   while (pages < 3) {  // three pages are enough for the test
     const resp = await fetch(`${URL}?${params}`, { headers: HEADERS });
     if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
     const page = await resp.json();
     pages += 1;
     followers.push(...page.users);
     if (!page.next_cursor) break;
     params.set("next_cursor", page.next_cursor);
   }
   
   console.log(followers.length, "followers in", pages, "requests");
   

5. Busque uma data antiga. Envie uma consulta com o operador until: do X para POST /search-tweets e confirme que o histórico de que a sua pergunta precisa volta, para a verificação 7.

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

6. Leia o seu saldo de novo. Chame GET /key-usage-info mais uma vez: remaining_requests caiu pelo número de chamadas que deram certo, uma por chamada em todos os endpoints, o que resolve a verificação 8.

O teste usa cerca de cinco requisições; o resto das 100 fica na chave para o trabalho que você veio testar.

#Escolha a API que passa nas oito

A API do Twitter certa é a que passa nas oito verificações no seu próprio trabalho, começando pelo preço de 1.000 resultados. Para ler dados públicos do X, essa é a Sorsa API: tweets a partir de US$ 0,014 por 1.000 em lotes de 100, seguidores a partir de US$ 0,007, 20 requisições por segundo em todos os planos, 99,9% de uptime nos termos, requisições com falha nunca cobradas, e ela nunca pede seu login do X. Passe a sua lista de candidatas pelas verificações, gaste algumas requisições grátis no seu trabalho real e compare a conta com a que você paga hoje. Mantenha a API oficial do X para os posts que a sua própria conta publica. Ordenado pelos mesmos números, o cenário está em A melhor API do Twitter.

#FAQ