Que dados você consegue obter da API do Twitter?

#Os 15 tipos de dados públicos do X que uma API devolve

Dados públicos do X são o que o X mostra a qualquer pessoa: posts de contas que não são protegidas, perfis, listas de seguidores e as contagens ao lado deles. Uma API os devolve em JSON em 15 tipos:

• Perfis: nome, bio, localização, data de entrada, contagens de seguidores, contas seguidas e posts, avatar e selo de verificado.
• Sobre esta conta: o país que o X associa à conta, quantas vezes e quando ela mudou de username e o status de X Premium.
• Seguidores e contas seguidas: a lista inteira dos dois lados, cada conta com seu perfil.
• Posts: texto, idioma, data, seis contagens de engajamento (curtidas, reposts, respostas, quotes, visualizações, bookmarks), links, mídia e o autor.
• Timelines: o que uma conta postou, suas respostas e seus reposts.
• Listas de engajamento: as respostas abaixo de um post, seus quotes e as contas que o repostaram.
• Busca de posts: qualquer consulta da Busca Avançada do X com seus operadores, em todo o arquivo desde 2006.
• Menções: posts que marcam uma conta, filtrados por curtidas, respostas, reposts e datas.
• Busca de contas: contas cujo nome, handle ou bio correspondem a uma palavra-chave.
• Listas: os membros de uma Lista, os seguidores dela e um feed único dos posts dos membros.
• Communities: os detalhes, os membros e os posts de uma Community, e uma busca dentro dela.
• Spaces: título, estado, anfitriões, oradores, ouvintes e contagens de ouvintes de uma sala de áudio ao vivo.
• Trends: o que está em alta em um país ou em uma cidade.
• X Articles: o texto completo de um post longo, com a imagem de capa e as métricas.
• Verificações: respostas de sim ou não, como se uma conta segue outra ou repostou um post.

Os dados privados ficam fora dessa lista. Desde junho de 2024 o X mostra quem curtiu um post só ao autor dele e as curtidas de uma conta só a ela mesma, e nenhuma API devolve as curtidas, os bookmarks nem as mensagens de outra pessoa; a lista completa do que você não consegue obter está mais abaixo.

O caminho até os dados também muda. A API oficial do X cobre a maioria dos 15 tipos, não tem campos para os dados do Sobre e cobra cada item que devolve; nosso guia de preços da API do X lista todas as tarifas.

#Obtenha cada tipo de dado com a Sorsa API

Para mapear um projeto nos dados do X, use a Sorsa API: ela devolve os 15 tipos por 45 endpoints com uma chave de API, todo plano roda a 20 requisições por segundo, e os preços começam em US$ 0,007 por 1.000 seguidores e US$ 0,014 por 1.000 tweets. Não precisa de conta de desenvolvedor do X, app nem OAuth, como explica nosso guia da API do Twitter sem conta de desenvolvedor.

Toda requisição custa o mesmo, então a tabela mostra quantos itens uma requisição carrega e quanto custam 1.000 itens, ao lado do preço de pagamento por uso (abre em uma nova aba) da API oficial do X para os mesmos dados. Os 45 endpoints, com seus parâmetros, estão na página de endpoints da Sorsa API.

• Perfis

  Endpoint da Sorsa API

  GET /info-batch (abre em uma nova aba)

  Por requisição

  100 perfis

  Sorsa API, por 1.000

  a partir de US$ 0,014

  API oficial do X, por 1.000

  US$ 10,00

• Sobre esta conta

  Endpoint da Sorsa API

  GET /about (abre em uma nova aba)

  Por requisição

  1 conta

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  sem esses campos

• Seguidores, contas seguidas

  Endpoint da Sorsa API

  GET /followers (abre em uma nova aba), GET /follows (abre em uma nova aba)

  Por requisição

  200 seguidores

  Sorsa API, por 1.000

  a partir de US$ 0,007

  API oficial do X, por 1.000

  US$ 10,00

• Posts por ID ou link

  Endpoint da Sorsa API

  POST /tweet-info-bulk (abre em uma nova aba)

  Por requisição

  100 posts

  Sorsa API, por 1.000

  a partir de US$ 0,014

  API oficial do X, por 1.000

  US$ 5,00, mais US$ 10,00 pelos autores a partir de 22 de nov.

• Timelines

  Endpoint da Sorsa API

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

  Por requisição

  20 posts

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00

• Respostas, quotes, quem repostou

  Endpoint da Sorsa API

  POST /comments (abre em uma nova aba), POST /quotes (abre em uma nova aba), POST /retweeters (abre em uma nova aba)

  Por requisição

  20

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00 posts, US$ 10,00 contas

• Busca de posts

  Endpoint da Sorsa API

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

  Por requisição

  20 posts

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00

• Menções

  Endpoint da Sorsa API

  POST /mentions (abre em uma nova aba)

  Por requisição

  20 posts

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00

• Busca de contas

  Endpoint da Sorsa API

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

  Por requisição

  20 contas

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 10,00

• Listas

  Endpoint da Sorsa API

  GET /list-tweets (abre em uma nova aba), GET /list-members (abre em uma nova aba)

  Por requisição

  20

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00 posts, US$ 10,00 membros

• Communities

  Endpoint da Sorsa API

  POST /community-tweets (abre em uma nova aba), POST /community-members (abre em uma nova aba)

  Por requisição

  20

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00 Communities, depois cada post ou membro

• Spaces

  Endpoint da Sorsa API

  GET /spaces (abre em uma nova aba)

  Por requisição

  1 Space

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  US$ 5,00

• Trends

  Endpoint da Sorsa API

  GET /trends (abre em uma nova aba)

  Por requisição

  1 local

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  US$ 10,00

• X Articles

  Endpoint da Sorsa API

  POST /article (abre em uma nova aba)

  Por requisição

  1 Article

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  US$ 5,00, lido como posts

• Verificações

  Endpoint da Sorsa API

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

  Por requisição

  1 resposta

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  sem chamada única: listas a US$ 10,00

Que dados cada trabalho exige

A maioria dos projetos lê dois ou três dos 15 tipos, e cada trabalho corresponde a um conjunto curto de endpoints:

• Monitoramento de marca e palavras-chave

  Dados que lê

  Busca de posts, menções

  Endpoints da Sorsa API

  POST /search-tweets, POST /mentions

• Pesquisa de público e de influenciadores

  Dados que lê

  Seguidores, perfis, dados do Sobre

  Endpoints da Sorsa API

  GET /followers, GET /info-batch, GET /about

• Acompanhamento de concorrentes

  Dados que lê

  Timelines, respostas, quotes

  Endpoints da Sorsa API

  POST /user-tweets, POST /comments, POST /quotes

• Datasets para pesquisa e IA

  Dados que lê

  Busca desde 2006, posts por ID

  Endpoints da Sorsa API

  POST /search-tweets, POST /tweet-info-bulk

• Sorteios e campanhas

  Dados que lê

  Verificações

  Endpoints da Sorsa API

  POST /check-follow, POST /check-retweet

• Acompanhar muitas contas ou um mercado

  Dados que lê

  Listas, trends

  Endpoints da Sorsa API

  GET /list-tweets, GET /trends

Sua primeira requisição

Três passos levam você de nenhuma conta ao seu primeiro perfil:

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

2. Peça um perfil. Chame o GET /info (abre em uma nova aba) com a chave no header ApiKey e indique a conta com exatamente um entre username, user_id ou user_link.

   curl -G "https://api.sorsa.io/v3/info" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=orbit_data_studio"
   

   {
     "id": "1593004418823766016",
     "username": "orbit_data_studio",
     "display_name": "Orbit Data Studio",
     "description": "Charts and notes on public conversation.",
     "location": "Lisbon",
     "created_at": "2022-11-16T09:41:12Z",
     "followers_count": 18420,
     "followings_count": 312,
     "tweets_count": 4127,
     "favourites_count": 9230,
     "media_count": 688,
     "verified": false,
     "protected": false,
     "can_dm": true,
     "possibly_sensitive": false,
     "bio_urls": ["https://orbit-data.example"],
     "pinned_tweet_ids": ["1981442093318201344"],
     "profile_image_url": "https://pbs.twimg.com/profile_images/orbit.jpg"
   }
   

   Ver resposta completa

3. Siga o cursor nas listas. Os endpoints que devolvem listas acrescentam next_cursor; envie-o de volta na requisição seguinte até ele voltar vazio. Um 401 significa chave errada, um 403 chave ausente ou sem requisições, e um 429 mais de 20 requisições em um segundo.

#O que um post contém: 22 campos e o autor

Um post da Sorsa API traz 22 campos, e o perfil completo do autor está dentro dele: o POST /tweet-info (abre em uma nova aba) devolve um post por link ou ID, e o POST /tweet-info-bulk devolve até 100 em uma requisição. Respostas, quotes e reposts trazem junto o post original, com o autor dele também.

A API oficial do X começa menor. A consulta de post dela devolve três campos por padrão, id, text e edit_history_tweet_ids, como diz o guia de campos (abre em uma nova aba); o resto exige tweet.fields, e o autor exige uma expansion que o X cobra como uma leitura de usuário de US$ 0,010 a partir de 22 de novembro de 2026, segundo o aviso do X (abre em uma nova aba).

Aqui está cada campo, com o nome que a API v2 oficial do X usa para a mesma coisa, para o código escrito para uma ou outra mapear direto:

• id, created_at, lang

  O que guarda

  O ID do post como string, a data em ISO 8601 e o código do idioma

  Campo da API v2 oficial do X

  id, created_at, lang

• full_text

  O que guarda

  O texto inteiro, posts longos incluídos

  Campo da API v2 oficial do X

  text, ou note_tweet.text para posts longos

• likes_count, retweet_count, reply_count, quote_count, bookmark_count

  O que guarda

  Contagens de engajamento no momento da requisição

  Campo da API v2 oficial do X

  public_metrics.like_count, retweet_count, reply_count, quote_count, bookmark_count

• view_count

  O que guarda

  Visualizações, que o X chama de impressões

  Campo da API v2 oficial do X

  public_metrics.impression_count

• conversation_id_str

  O que guarda

  ID do primeiro post da thread

  Campo da API v2 oficial do X

  conversation_id

• is_reply, in_reply_to_tweet_id, in_reply_to_username

  O que guarda

  Se é resposta, a qual post e a quem

  Campo da API v2 oficial do X

  referenced_tweets, in_reply_to_user_id

• is_quote_status, quoted_status, retweeted_status

  O que guarda

  O post citado ou o original de um repost, por inteiro

  Campo da API v2 oficial do X

  referenced_tweets mais uma expansion

• entities

  O que guarda

  Fotos, vídeos e links: tipo, link, prévia

  Campo da API v2 oficial do X

  entities, attachments mais uma expansion de mídia

• user

  O que guarda

  O perfil completo do autor

  Campo da API v2 oficial do X

  author_id mais uma expansion

• is_replies_limited, paid_partnership, made_with_ai

  O que guarda

  Limites de resposta e os rótulos de parceria paga e de feito com IA do X

  Campo da API v2 oficial do X

  reply_settings, paid_partnership

Para ler 100 posts de uma vez, envie os IDs ou links deles ao endpoint em lote:

import requests

URL = "https://api.sorsa.io/v3/tweet-info-bulk"
HEADERS = {"ApiKey": "YOUR_API_KEY"}

ids = ["1985274530112847105", "1985190021774452736"]  # up to 100
r = requests.post(URL, headers=HEADERS, json={"tweet_links": ids})
r.raise_for_status()
for t in r.json()["tweets"]:
    print(t["id"], t["view_count"], t["likes_count"], t["user"]["username"])

const res = await fetch("https://api.sorsa.io/v3/tweet-info-bulk", {
  method: "POST",
  headers: { ApiKey: "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ tweet_links: ["1985274530112847105"] }),
});
const { tweets } = await res.json();
for (const t of tweets) console.log(t.id, t.view_count, t.user.username);

Bom saber

Toda contagem é um snapshot. likes_count, view_count e as demais são os valores no momento da sua requisição e continuam crescendo depois dela, então guarde o horário de cada leitura antes de comparar um post com outro.

#O que um perfil contém, e os dados do Sobre

Um perfil da Sorsa API tem 19 campos, vindos do GET /info para uma conta ou do GET /info-batch para até 100. O GET /about acrescenta mais 7 que o X mostra só na página "Sobre esta conta" de uma conta.

• id

  O que guarda

  O ID permanente da conta, como string

  Campo da API v2 oficial do X

  id

• username, display_name

  O que guarda

  O handle sem @ e o nome de exibição

  Campo da API v2 oficial do X

  username, name

• description, bio_urls, location, created_at

  O que guarda

  Bio, os links dela, localização como digitada, data de entrada

  Campo da API v2 oficial do X

  description, entities, location, created_at

• followers_count, followings_count, tweets_count, favourites_count, media_count

  O que guarda

  Seguidores, contas seguidas, posts, posts curtidos, mídia postada

  Campo da API v2 oficial do X

  contagens de public_metrics

• verified, protected, possibly_sensitive, can_dm

  O que guarda

  Selo, posts protegidos, marcação de sensível, aberta a DMs

  Campo da API v2 oficial do X

  verified, protected, receives_your_dm

• pinned_tweet_ids, profile_image_url, profile_background_image_url

  O que guarda

  Posts fixados, avatar e banner

  Campo da API v2 oficial do X

  pinned_tweet_id, profile_image_url, profile_banner_url

Os dados do Sobre não têm equivalente na API oficial do X: o dicionário de dados (abre em uma nova aba) dela não lista país nem histórico de usernames de um usuário. O GET /about devolve:

• country: o país que o X associa à conta;
• username_change_count e last_username_change_at: quantas vezes o handle mudou e quando mudou pela última vez;
• is_blue_verified e premium_start_at: o check do X Premium e desde quando;
• source e affiliate_username: a origem da conta como o X a mostra e a conta por trás do selo de afiliação.

Para uma conta, o Localizador de país de conta do Twitter gratuito mostra o mesmo país no navegador.

Bom saber

Guarde os IDs como strings. Os IDs de posts e de contas são números de 64 bits que o JavaScript arredonda quando os lê como números. Guarde o id da conta, não o username, que o dono pode mudar a qualquer momento.

#Seguidores, listas de engajamento e verificações de sim ou não

As listas de contas vêm em páginas de perfis completos. GET /followers, GET /follows e GET /verified-followers (abre em uma nova aba) devolvem até 200 por requisição, então 1 milhão de seguidores levam 5 mil requisições, a partir de US$ 7; o guia para exportar seguidores do Twitter traz o loop de cursor e o CSV.

Em torno de um único post, três endpoints devolvem o engajamento público dele, 20 itens por página:

• POST /comments: as respostas abaixo dele, ordenadas por relevância, recência ou curtidas;
• POST /quotes: os posts que o citam, cada um com o autor;
• POST /retweeters: as contas que o repostaram, das mais novas às mais antigas, como perfis completos.

A produção de uma conta vem do POST /user-tweets, com type em posts, replies ou retweets. Ele percorre a timeline inteira, além dos 3.200 posts mais recentes onde o endpoint de timeline da API oficial do X para; o guia para baixar todos os tweets de um usuário o transforma em um arquivo.

As verificações respondem a uma pergunta por requisição, a partir de US$ 0,0014 cada:

• POST /check-follow: uma conta segue outra;
• POST /check-retweet (abre em uma nova aba): uma conta repostou um post, varrendo 100 reposts por requisição;
• POST /check-quoted (abre em uma nova aba): quoted, retweet ou not_found;
• GET /check-comment (abre em uma nova aba): uma conta respondeu, e a própria resposta;
• POST /check-community-member (abre em uma nova aba): uma conta está em uma Community;
• GET /check-shadowban (abre em uma nova aba): ban na busca e ban nas sugestões de busca, clean, banned ou unknown, em cache por uma hora.

O guia da API de verificação do Twitter usa essas verificações em um sorteio ou em uma campanha.

#Busca, Listas, Communities, Spaces, trends e Articles

O POST /search-tweets aceita qualquer consulta da Busca Avançada do X, com from:, to:, since:, until:, frases exatas e hashtags, ordenada por popular ou latest, em todo o arquivo desde 2006. O guia de dados históricos do Twitter cobre extrações por intervalo de datas.

O POST /mentions encontra posts que marcam uma conta e acrescenta filtros: min_likes, min_replies, min_retweets, e since_date e until_date em AAAA-MM-DD. O POST /search-users encontra contas por uma palavra no nome, no handle ou na bio.

Uma Lista acompanha muitas contas de uma vez: uma requisição GET /list-tweets devolve os posts mais recentes de todos os membros dela, e uma Lista comporta até 5.000 contas. O GET /list-members e o GET /list-followers (abre em uma nova aba) devolvem as contas dela como perfis.

As Communities têm cinco endpoints: POST /community-info (abre em uma nova aba) (nome, descrição, número de membros, banner, criador e horário de criação como timestamp Unix), POST /community-members, POST /community-tweets e POST /community-search-tweets (abre em uma nova aba) (popular ou latest), e POST /search-communities (abre em uma nova aba), até 10 por requisição.

O GET /spaces recebe um ID ou link de Space e devolve o título, o estado, o início programado e o criador, os participantes divididos em admins, oradores e ouvintes, as configurações dele, como replay e clipes, e as estatísticas: ouvintes ao vivo, participantes e visualizações do replay. Os horários vêm como números Unix, enquanto o resto da API usa datas ISO 8601.

O GET /trends recebe um WOEID, o Where On Earth ID de um país ou de uma cidade, e devolve o nome, a query de busca e o link de cada trend. O POST /article devolve um X Article: texto completo, prévia, imagem de capa, data de publicação, as contagens dele com as visualizações em views_count e o perfil do autor.

#O que nenhuma API do Twitter devolve

Nenhuma API devolve dados que o X mantém privados, e a API oficial do X não é exceção. Em 11 de junho de 2024, o X anunciou (abre em uma nova aba) que os endpoints de curtidas dele devolvem curtidas e quem curtiu só dos posts da própria conta autenticada, e um resultado vazio para todos os outros posts.

Cada linha abaixo tem um sinal público que você pode ler no lugar:

• Quem curtiu um post

  Por que nenhuma API o devolve

  Privado desde junho de 2024: só o autor do post vê

  O que você pode ler no lugar

  likes_count, mais as respostas, quotes e quem repostou, que são públicos

• As curtidas de uma conta

  Por que nenhuma API o devolve

  Privadas para a própria conta desde junho de 2024

  O que você pode ler no lugar

  favourites_count, quantos posts ela curtiu

• Bookmarks

  Por que nenhuma API o devolve

  Privados para a conta que os salvou

  O que você pode ler no lugar

  bookmark_count em cada post

• Mensagens diretas

  Por que nenhuma API o devolve

  Privadas entre os participantes

  O que você pode ler no lugar

  can_dm, se a conta as aceita

• Posts de contas protegidas

  Por que nenhuma API o devolve

  Visíveis só para seguidores aprovados

  O que você pode ler no lugar

  O perfil, com protected: true

• Posts apagados

  Por que nenhuma API o devolve

  Somem do X quando apagados

  O que você pode ler no lugar

  Só cópias que você guardou antes

• Quem viu um post ou perfil

  Por que nenhuma API o devolve

  O X mostra visualizações só como um número

  O que você pode ler no lugar

  view_count

• Listas passadas de seguidores, datas de follow

  Por que nenhuma API o devolve

  O X não guarda histórico público de quem seguiu quando

  O que você pode ler no lugar

  Exporte a lista em intervalos fixos e compare pelo id

• E-mail, telefone

  Por que nenhuma API o devolve

  Nunca públicos no X

  O que você pode ler no lugar

  Nada

Até a API oficial do X lê curtidas, bookmarks e mensagens só da conta que autorizou o app por OAuth, e nunca de outra pessoa.

O que a Sorsa API deixa de fora por design

A Sorsa API lê e nunca escreve: sem postar, curtir, seguir nem DMs. Ela nunca pede seu login do X, então sua conta não corre risco; para postar também, combine-a com a API oficial do X. Ela funciona sob requisição, sem stream nem webhook: os posts novos chegam consultando o POST /search-tweets ou o GET /list-tweets, a 20 requisições por segundo em todos os planos.

#Quanto custa cada tipo de dado por 1.000

A Sorsa API cobra uma requisição seja qual for o que ela devolve, então o preço por 1.000 cai à medida que as páginas crescem: a partir de US$ 0,007 por 1.000 seguidores (200 por página), US$ 0,014 por 1.000 posts ou perfis consultados por ID (100 por requisição) e US$ 0,07 por 1.000 resultados de busca (cerca de 20 por página). A API oficial do X cobra cada item: US$ 5,00 por 1.000 posts e US$ 10,00 por 1.000 perfis ou seguidores, e a partir de 22 de novembro o autor de cada post soma US$ 0,010.

Requisições com falha nunca são cobradas, e a API oficial do X para em 3 milhões de leituras de posts por mês, a partir do que o X vende só contratos Enterprise. As 100 requisições grátis que toda conta nova ganha cobrem até 10 mil tweets ou 20 mil seguidores.

#Leia os 15 tipos com uma chave

Uma API devolve 15 tipos de dados públicos do X e nenhum dos privados. Para lê-los, use a Sorsa API: uma chave, 45 endpoints, tweets a partir de US$ 0,014 por 1.000 e seguidores a partir de US$ 0,007, e 100 requisições grátis para começar, sem cartão.

#Perguntas frequentes