Quais dados você consegue tirar da API do Twitter (X) em 2026

Por Sorsa Editorial

Atualizado: 8 de julho de 2026. Adicionamos as tarifas por 1.000 unidades de dado e a oferta inicial de 100 requisições grátis, atualizamos contra o preço de pagamento por uso do X após a mudança de 20 de abril de 2026 e confirmamos a restrição de privacidade de curtidas de junho de 2024 nos dados recuperáveis.

Em resumo: A API do Twitter (X) expõe dados públicos de perfil, o conteúdo completo de tweet com métricas de engajamento como curtidas, retweets, respostas e visualizações, busca por palavra-chave e por menção, listas de seguidores e de seguindo, detalhes de Space de áudio, e participação em list e community. Ela também verifica se uma conta seguiu, deu retweet ou respondeu. Postar exige acesso de escrita separado.

O que você pode recuperar, e quanto cada chamada custa, depende de qual API você usa. A API oficial do X cobra por recurso, então cada perfil, tweet ou seguidor em uma resposta é uma cobrança à parte, e desde fevereiro de 2026 não há plano gratuito. A Sorsa API é uma API alternativa do Twitter (X) para dados públicos que funciona diferente. A cobrança é fixa por requisição, então uma chamada conta como uma requisição não importa quantos itens ela retorna, em 40 endpoints somente leitura. Uma única chamada /followers retorna até 200 perfis por uma requisição, e /tweet-info-bulk retorna até 100 tweets completos com dados de autor incluídos, também por uma requisição. A autenticação é uma única chave de API em um cabeçalho, sem fluxo OAuth e sem revisão de app. Nos endpoints de lote o dado dá a partir de US$ 0,02 por 1.000 tweets e a partir de US$ 0,01 por 1.000 perfis, e uma franquia única de 100 requisições grátis, sem cartão e que nunca expira, abre todos os 40 endpoints antes de qualquer plano começar. As seções abaixo catalogam cada categoria de dado público disponível e os campos exatos que cada uma retorna.

Nesta página

• Quais dados você consegue tirar da API do Twitter (X)?
• Dados de perfil e de conta
• Conteúdo de tweet e métricas de engajamento
• Dados de busca e históricos
• Dados de Spaces de áudio
• Listas e Comunidades
• Verificando ações de usuário
• Utilitários de identificador de conta
• O que você não consegue tirar da API do Twitter (X)
• Dá para postar ou escrever pela API?
• Quanto custa acessar esse dado
• Primeiros passos
• Perguntas frequentes

Quais dados você consegue tirar da API do Twitter (X)? {#what-data-can-you-get-from-the-twitterx-api}

A API do Twitter (X) cobre sete tipos de dado centrais: perfis de usuário e seus grafos de seguidores, tweets individuais e suas métricas de engajamento, busca por palavra-chave e por menção, Spaces de áudio, Listas e Comunidades, verificação de ações de usuário como follows e retweets, e utilitários de conversão de identificador. A maior parte disso é dado público de leitura; postagem e mensagens diretas são capacidades de escrita separadas.

Na prática, isso se divide em sete categorias recuperáveis:

• Perfis e o grafo de seguidores: nome de exibição, bio, localização, contadores públicos e status de verificação, mais listas de seguidores, de seguindo e de seguidores verificados.
• Tweets e engajamento: texto completo, idioma, timestamp e os contadores de curtida, retweet, resposta, quote, visualização e salvamento, com mídia e links retornados como entidades estruturadas.
• Busca: busca por palavra-chave, frase, autor e data com operadores avançados, acompanhamento de menções e busca de contas alcançando o arquivo até 2006.
• Spaces de áudio: título, estado, criador, o detalhamento de admin, palestrante e ouvinte, e estatísticas de ouvintes ao vivo e de replay.
• Listas e Comunidades: membros, assinantes e feeds de post para Listas, e membros, feeds e busca escopada para Comunidades.
• Verificação de ação: checagens booleanas de se uma conta seguiu, respondeu, citou, repostou ou entrou em uma comunidade.
• Utilitários de identificador: conversão entre nomes de usuário, IDs numéricos e links de perfil.

Todo endpoint da API que rodamos autentica com uma chave em um cabeçalho ApiKey. Uma consulta de perfil e uma extração de tweet em massa ficam assim:

curl -H "ApiKey: YOUR_API_KEY" \
  "https://api.sorsa.io/v3/info?username=elonmusk"

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

Dados de perfil e de conta {#profile-and-account-data}

Os dados de perfil da API do Twitter (X) incluem o nome de exibição, o @, a bio, a localização, as imagens de perfil e de banner, a data de criação da conta e o status de verificação, junto com se a conta é protegida. Eles também incluem contadores públicos: seguidores, seguindo, total de posts, curtidas dadas e mídia. As listas de seguidores e de seguindo estão disponíveis como conjuntos paginados de perfis completos.

Estes são os campos mais requisitados para pesquisa de audiência e de concorrentes. Uma única chamada /info retorna o perfil completo, incluindo followers_count, followings_count, tweets_count, favourites_count, media_count, verified, protected, created_at no formato ISO 8601, location, quaisquer URLs encontradas na bio e os IDs de tweets fixados. Para o grafo de seguidores, /followers e /follows retornam até 200 perfis por requisição, e /verified-followers estreita a lista para apenas contas verificadas. Como puxar listas de seguidores e de seguindo cobre a paginação e a economia por requisição.

Um campo é fácil de deixar passar: o país da conta. O endpoint /about retorna exatamente três valores, o país associado à conta, o número total de mudanças de nome de usuário e a data da mudança mais recente. Esse campo de país é o que move uma checagem de onde uma conta está baseada.

Conteúdo de tweet e métricas de engajamento {#tweet-content-and-engagement-metrics}

Para qualquer post público, a API do Twitter (X) retorna o texto completo, o idioma, o timestamp e a conversa a que ele pertence, junto com as métricas de engajamento: curtidas, retweets, respostas, quotes, visualizações e salvamentos. Mídia e links anexados voltam como entidades estruturadas. Para respostas, quotes e reposts, o post original e o autor dele ficam aninhados na resposta.

Os contadores de visualização estão disponíveis nos posts desde dezembro de 2022, retornados como view_count ao lado de likes_count, retweet_count, reply_count, quote_count e bookmark_count. Uma chamada /tweet-info retorna um post; /tweet-info-bulk aceita até 100 IDs de post e retorna todos em uma única requisição, que é a diferença entre uma chamada cobrável e cem. Para puxar uma linha do tempo, /user-tweets retorna os posts de um usuário página por página, enquanto /comments, /quotes e /retweeters retornam as respostas, os quote posts e as contas que repostaram sob um dado post. Trabalhando com respostas, quotes e quem repostou pela API vai mais fundo em cada um desses endpoints.

Há um sinal de engajamento que você não consegue recuperar: a lista de contas que curtiram um post. O X tornou as curtidas privadas em 12 de junho de 2024, então apenas os contadores de curtida são expostos, não as identidades por trás delas. Você ainda consegue obter as contas que deram retweet, citaram ou responderam.

Posts de formato longo também estão disponíveis. Puxar o texto completo de X Articles retorna o corpo do artigo, a imagem de capa e as métricas, e trending topics por localização retorna as tendências atuais para uma dada região.

Dados de busca e históricos {#search-and-historical-data}

A API do Twitter (X) pode buscar posts públicos por palavra-chave, frase, hashtag, autor e data usando operadores de busca avançada, retornar posts que mencionam um @ específico e buscar contas por palavra-chave. A busca alcança o arquivo público completo até 2006, não apenas posts recentes, então a pesquisa histórica é possível.

A busca é onde a sintaxe de operador importa. /search-tweets aceita os mesmos operadores avançados que a busca do Twitter, incluindo from:, to:, since:, until:, frases exatas entre aspas e hashtags, e retorna cerca de 20 posts por página com ordenação popular ou latest. A referência de operadores de busca avançada para a API de busca de tweets percorre a montagem de consulta.

Para trabalho de marca e de reputação, /mentions retorna posts mencionando um @ e oferece o conjunto de filtros mais rico de qualquer endpoint de busca: curtidas, respostas e retweets mínimos, mais os limites since_date e until_date. Acompanhar menções em escala cobre os filtros. Quando você precisa de posts de anos atrás em vez desta semana, buscar o arquivo de tweets mais antigos explica como consultas delimitadas por data alcançam os primeiros posts da plataforma.

Dados de Spaces de áudio {#audio-spaces-data}

A API do Twitter (X) retorna dados sobre Spaces de áudio: o título, o estado atual, o horário de início agendado, o perfil completo do criador e um detalhamento dos participantes por papel como admins, palestrantes e ouvintes. Ela também expõe configurações de acesso e estatísticas ao vivo, incluindo ouvintes totais e de pico e visualizações de replay.

Uma chamada /spaces aceita um ID ou link de Space e retorna o objeto completo. Ao contrário da maioria dos endpoints, os timestamps de Space são inteiros Unix em vez de strings ISO 8601, um detalhe que vale tratar explicitamente quando você parseia created_at, scheduled_start e os horários de entrada dos participantes. O detalhamento de participantes é útil para identificar quais contas hospedaram ou falaram versus simplesmente ouviram.

Listas e Comunidades {#lists-and-communities}

A API do Twitter (X) expõe Listas e Comunidades do Twitter (X). Para uma Lista, você pode recuperar os perfis de membros dela, os assinantes dela e um feed de posts dos membros dela. Para uma Comunidade, você pode recuperar os membros dela, o feed de posts dela e rodar uma busca por palavra-chave escopada apenas àquela comunidade.

Listas são uma forma limpa de acompanhar um conjunto fixo de contas. /list-members retorna os perfis em uma Lista, /list-followers retorna as contas assinadas a ela, e /list-tweets retorna um feed combinado de posts dos membros dela. Comunidades funcionam da mesma forma por /community-members, /community-tweets e /community-search-tweets, o último dos quais restringe uma busca por palavra-chave a uma única comunidade. Extrair membros, posts e seguidores de Listas e Comunidades cobre os dois em um lugar só.

Verificando ações de usuário {#verifying-user-actions}

Além do dado bruto, a API do Twitter (X) pode verificar ações de usuário específicas: se uma conta segue outra, se um usuário respondeu a um dado post, se ele o citou ou repostou, e se ele pertence a uma comunidade específica. Cada checagem retorna um resultado booleano, que é do que a verificação de sorteio e de campanha depende.

Essas checagens são a espinha dorsal da auditoria de sorteio e de campanha. /check-follow confirma se uma conta segue outra, /check-comment confirma uma resposta sob um post específico, /check-quoted e /check-retweet confirmam quotes e reposts, e /check-community-member confirma a participação. Checagens de follow bidirecionais levam duas chamadas, uma em cada direção, já que uma única checagem é unidirecional. Verificar follows, respostas, quotes e reposts para campanhas cobre o fluxo completo.

Utilitários de identificador de conta {#account-identifier-utilities}

A API do Twitter (X) também trata a conversão de identificador. Você pode converter um nome de usuário para o seu ID numérico de usuário permanente, converter um ID numérico de volta para o nome de usuário atual e extrair um ID de usuário de uma URL de perfil. Como os nomes de usuário podem mudar mas os IDs numéricos nunca mudam, armazenar o ID é a forma confiável de acompanhar uma conta ao longo do tempo.

Nomes de usuário mudam; o ID numérico atribuído no cadastro não. /username-to-id e /id-to-username convertem entre os dois, e /link-to-id puxa o ID direto de uma URL de perfil. Converter entre nomes de usuário, IDs de usuário e links de perfil explica por que o armazenamento baseado em ID sobrevive a mudanças de @. Uma chamada /key-usage-info à parte reporta quantas requisições restam na sua chave.

O que você não consegue tirar da API do Twitter (X) {#what-you-cannot-get-from-the-twitterx-api}

Alguns dados estão fora de alcance independentemente da API. Você não pode ler as mensagens diretas de outros usuários, recuperar conteúdo de contas protegidas que você não segue, ou recuperar posts apagados. Você não pode obter a lista de contas que curtiram um post, já que o X tornou as curtidas privadas em junho de 2024. APIs somente leitura adicionalmente não podem postar, responder, seguir ou enviar mensagens.

Conhecer as fronteiras economiza chamadas desperdiçadas. Contas privadas e protegidas retornam apenas o que um espectador deslogado veria, posts apagados somem do índice, e mensagens diretas entre outros usuários nunca são expostas. A restrição de curtidas atrapalha as auditorias de engajamento com mais frequência: você obtém o contador de curtidas em um post mas não as contas por trás dele, então a análise de audiência se apoia em seguidores, quem respondeu, quem citou e quem repostou. A limitação somente leitura é uma escolha de design deliberada, tratada na próxima seção.

Dá para postar ou escrever pela API? {#can-you-post-or-write-through-the-api}

A API oficial do X permite ações de escrita: postar, responder e enviar mensagens diretas, todas cobradas por requisição. A partir de 20 de abril de 2026, as escritas de follow, curtida e quote post passaram para acesso só de Enterprise. APIs de terceiros somente leitura não escrevem de forma alguma; elas recuperam dados públicos e nada mais, o que remove qualquer risco de permissão de escrita às contas conectadas.

Se você precisa de escritas é a primeira bifurcação na escolha de uma API. Se o objetivo é publicar ou automatizar, a API oficial do X é a rota, e postar uma mensagem simples custa US$ 0,015 por requisição enquanto um post contendo uma URL custa US$ 0,20. Se o objetivo é ler dados públicos em volume, a capacidade de escrita é peso morto, e uma API somente leitura como a que rodamos abre mão dela de propósito: sem postagem significa sem escopos de escrita OAuth, sem revisão de permissão de app e sem risco de um token fazer algo não intencional a uma conta. Para equipes pesando a mudança, migrar para fora da API oficial do X mapeia os endpoints de leitura.

Quanto custa acessar esse dado {#what-it-costs-to-access-this-data}

O custo de dados do Twitter (X) depende do modelo de cobrança, não só do volume. A API oficial do X cobra por recurso: US$ 0,005 por leitura de post e US$ 0,010 por leitura de perfil, então uma única busca retornando 20 posts mais os autores deles custa cerca de US$ 0,30. APIs fixas por requisição cobram uma vez por chamada independentemente de quantos itens voltam, o que favorece o trabalho de leitura intensa.

Para acesso de leitura intensa, um modelo fixo por requisição é dramaticamente mais barato do que a cobrança por recurso assim que o volume passa de cerca de 10.000 leituras de post por mês.

Se você precisa postar, rodar streaming filtrado ou manter um acordo de conformidade enterprise, a API oficial do X é a ferramenta certa. Para acesso de leitura intensa a dados públicos a um preço fixo e previsível, um provedor de tarifa fixa vence, e a diferença por unidade de dado é a razão. O preço da Sorsa lista os planos, e um detalhamento completo do preço da API do X em 2026 mostra as contas por recurso em detalhe.

Uma equipe que saiu da cobrança por recurso

Uma equipe de análise social de cerca de 10 pessoas chegou até nós depois de um mês construindo diretamente na API oficial do X. O produto delas puxava perfis, posts recentes e métricas de engajamento em alguns milhares de contas rastreadas, e a conta por recurso, onde cada leitura de post mais cada perfil de autor contavam à parte, estava subindo além do que o preço delas conseguia absorver. Mover a mesma carga de leitura para chamadas fixas por requisição, com os dados de autor já incluídos em cada resposta de tweet e endpoints de lote colapsando extrações de cem itens em requisições únicas, cortou os custos de dados delas em até 50x. Os recursos de escrita pelos quais elas vinham pagando, elas nunca usaram.

Primeiros passos {#getting-started}

Mapear o que você precisa para o endpoint certo é a forma mais rápida de escopar um projeto. O dado somente leitura acima está disponível por 40 endpoints em uma única chave de API, com um fixo de 20 requisições por segundo em todo plano e configuração em poucos minutos, sem revisão de app. Uma franquia única de 100 requisições grátis, sem cartão e que nunca expira, abre cada endpoint para teste antes de você pagar. Teste qualquer endpoint no playground da API no navegador sem escrever código, e depois leia a referência de endpoints quando estiver pronto para integrar. O dado sai a partir de US$ 0,02 por 1.000 tweets e a partir de US$ 0,01 por 1.000 perfis nos endpoints de lote, com planos de US$ 49 por mês por 10.000 requisições a US$ 899 por 500.000.

Perguntas frequentes {#frequently-asked-questions}

Dá para obter contadores de visualização e de salvamento da API do Twitter (X)?

Sim. A API do Twitter (X) retorna contadores de visualização nos posts, disponíveis desde dezembro de 2022, bem como contadores de salvamento, ao lado das curtidas, retweets, respostas e quotes padrão. Eles voltam como campos numéricos em cada objeto de post. O único sinal de engajamento não disponível é a lista de contas que curtiram um post, que se tornou privada em junho de 2024.

Dá para postar tweets pela API do Twitter (X)?

A API oficial do X permite postar, responder e mensagens diretas, cobradas por requisição, embora as escritas de follow, curtida e quote post tenham passado para acesso só de Enterprise em abril de 2026. APIs de terceiros somente leitura não postam de forma alguma. Se o seu projeto só lê dados públicos, o acesso de escrita é desnecessário e adiciona um risco de permissão que você pode evitar.

Qual é a forma mais barata de obter dados do Twitter (X) por uma API?

Para trabalho de leitura intensa, uma API fixa por requisição é a rota mais barata assim que você passa de cerca de 10.000 leituras de post por mês. A Sorsa cobra uma requisição por chamada independentemente de quantos itens voltam e inclui perfis de autor nas respostas de tweet, o que dá a partir de US$ 0,02 por 1.000 tweets e a partir de US$ 0,01 por 1.000 perfis nos endpoints de lote, contra os US$ 0,005 por leitura de post e US$ 0,010 por leitura de perfil da API oficial. Uma franquia única de 100 requisições grátis, sem cartão, deixa você testar cada endpoint antes de pagar.

Até que ponto no passado os dados da API do Twitter (X) vão?

A busca alcança o arquivo público completo até 2006, o ano em que o Twitter foi lançado, não apenas posts recentes. Consultas delimitadas por data usando operadores como since e until podem mirar uma janela histórica específica. Dados em tempo real e históricos usam os mesmos endpoints de busca, então uma consulta pode abranger posts recentes ou mais antigos.

Você precisa de uma conta de desenvolvedor para acessar os dados da API do Twitter (X)?

A API oficial do X exige uma conta de desenvolvedor, um app aprovado e um fluxo OAuth antes de qualquer chamada de dado. Um provedor de tarifa fixa como a Sorsa remove isso: uma única chave de API em um cabeçalho de requisição autentica cada endpoint, sem revisão de app e com configuração em poucos minutos. Ler dados públicos do X dessa forma não exige o programa de desenvolvedor da plataforma.

Quais dados você não consegue tirar da API do Twitter (X)?

Você não pode ler as mensagens diretas de outros usuários, ver conteúdo de contas protegidas que você não segue, recuperar posts apagados ou recuperar a lista de contas que curtiram um post, já que as curtidas se tornaram privadas em junho de 2024. As auditorias de engajamento se apoiam em seguidores, quem respondeu, quem citou e quem repostou em vez de quem curtiu.

Revisado por Keksich, fundador da Sorsa, profissional de marketing e pesquisador da API do X.

Este guia se apoia no nosso trabalho do dia a dia operando a API somente leitura do X da Sorsa e na sua documentação pública, cruzada com o preço de pagamento por uso de 2026 publicado do X e a mudança de privacidade de curtidas de junho de 2024. Nomes de endpoint, campos de resposta e limites foram verificados contra a API ao vivo, e o preço reflete as tarifas em vigor após a atualização de 20 de abril de 2026 do X. Mais sobre a equipe por trás destes guias está na página Sobre da Sorsa. Verificado em 8 de julho de 2026.