API de Listas do Twitter: obtenha membros e tweets

#O que uma API de Listas do Twitter consegue ler

Uma Lista do X é um grupo nomeado de até 5.000 contas, com a própria timeline, e uma API consegue ler três partes de uma Lista pública. Cada parte vem do seu próprio endpoint:

• Membros: as contas que o dono da Lista adicionou. É o conjunto curado que as pessoas exportam para planilhas e CRMs.
• Seguidores: as pessoas que seguem a Lista para ler a timeline dela, que o X também chama de assinantes. Não são os seguidores dos próprios membros; para os seguidores de uma conta, veja o guia da API de seguidores do Twitter.
• O feed: a timeline da Lista, os posts mais novos de todos os membros em um só lugar.

O ID da Lista é o número longo no endereço dela, x.com/i/lists/1234567890123456789. Toda requisição de Lista parte dele.

Algumas regras da Central de Ajuda do X (abre em uma nova aba) definem o que você pode ler. As Listas são públicas por padrão, e qualquer pessoa pode seguir uma pública. Uma Lista privada só é visível para a conta que a criou, então nenhuma API a lê. Os nomes vão até 25 caracteres. Ninguém sai da Lista de outra pessoa, a não ser bloqueando o dono dela.

Há dois dados que nenhum endpoint de Lista retorna: quando uma conta foi adicionada e quem saiu. Para acompanhar mudanças, exporte os membros em intervalos regulares e compare os arquivos pelo id. Como o dono escolhe as contas uma vez no app do X e o seu código só precisa do ID, uma Lista também é a unidade mais simples para o monitoramento do Twitter em tempo real.

#Exporte os membros de uma Lista para CSV

Para exportar uma Lista, use a Sorsa API, uma API e scraper do Twitter (X): o GET /list-members (abre em uma nova aba) dela retorna até 200 membros por requisição, então até uma Lista cheia, com 5.000 membros, leva 25 requisições. Os passos abaixo gravam todos os membros em um único arquivo CSV.

1. Copie o ID da Lista. Abra a Lista no x.com e pegue o número depois de /lists/ na barra de endereço.

2. Obtenha uma chave. Cadastre-se e copie sua chave de API no painel. Sem cartão, e as primeiras 100 requisições são grátis.

3. Peça a primeira página. Envie o ID como list_id, com a sua chave no header ApiKey.

   curl -G "https://api.sorsa.io/v3/list-members" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "list_id=1234567890123456789"
   

   {
     "users": [
       {
         "id": "1592041833471827968",
         "username": "dana_tracks_markets",
         "display_name": "Dana Tracks Markets",
         "description": "Rates, FX and the odd chart.",
         "location": "Chicago, IL",
         "followers_count": 48210,
         "followings_count": 612,
         "tweets_count": 15873,
         "verified": true,
         "protected": false,
         "created_at": "2014-03-09T16:22:41Z"
       }
     ],
     "next_cursor": "DAABCgABGc3yPLu__-0KAAIZsbqf"
   }
   

   Ver resposta completa

4. Siga o cursor e grave as linhas. Devolva o next_cursor a cada requisição até ele voltar vazio, e salve cada página assim que chegar.

   import csv
   import requests
   
   URL = "https://api.sorsa.io/v3/list-members"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   FIELDS = ["id", "username", "display_name",
             "followers_count", "verified", "created_at"]
   
   
   def export_members(list_id, path="list_members.csv"):
       params = {"list_id": list_id}
       with open(path, "w", newline="", encoding="utf-8") as f:
           out = csv.DictWriter(f, fieldnames=FIELDS,
                                extrasaction="ignore")
           out.writeheader()
           while True:
               r = requests.get(URL, headers=HEADERS,
                                params=params, timeout=30)
               r.raise_for_status()
               page = r.json()
               out.writerows(page.get("users", []))
               cursor = page.get("next_cursor")
               if not cursor:
                   break
               params["next_cursor"] = cursor
   
   
   export_members("1234567890123456789")
   

   import { writeFileSync } from "node:fs";
   
   const URL = "https://api.sorsa.io/v3/list-members";
   const headers = { ApiKey: "YOUR_API_KEY" };
   const rows = [["id", "username", "followers_count"]];
   
   let cursor = null;
   do {
     const params = new URLSearchParams({
       list_id: "1234567890123456789",
     });
     if (cursor) params.set("next_cursor", cursor);
     const res = await fetch(`${URL}?${params}`, { headers });
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     const page = await res.json();
     for (const u of page.users ?? []) {
       rows.push([u.id, u.username, u.followers_count]);
     }
     cursor = page.next_cursor;
   } while (cursor);
   
   writeFileSync("list_members.csv", rows.map((r) => r.join(",")).join("\n"));
   

Cada linha é um perfil público completo: os mesmos id, handle, bio, localização, contadores e data de criação que os endpoints de perfil retornam. Use o id como chave nos seus arquivos, já que um handle pode mudar e o ID nunca muda. Um 403 significa que a chave está ausente ou sem requisições; um 429 indica mais de 20 requisições em um segundo nessa chave, então espere um segundo e envie de novo.

O mesmo loop exporta os seguidores de uma Lista pelo GET /list-followers (abre em uma nova aba), também com até 200 seguidores por página. Troque o caminho e envie a Lista como list_link em vez de list_id.

Bom saber

Os dois parâmetros são diferentes. O /list-members e o /list-tweets recebem list_id, só o número. O /list-followers recebe list_link, que aceita a URL inteira da Lista ou o número. Colar o endereço completo em list_id é um deslize fácil, então reduza-o aos dígitos antes.

#Leia os tweets de uma Lista como um único feed

O GET /list-tweets (abre em uma nova aba) retorna a timeline da Lista: os posts mais novos de todos os membros, cerca de 20 por requisição, cada um com texto, data, contagens de curtidas, respostas, reposts e visualizações, e o perfil do autor. Uma requisição cobre todas as contas da Lista, seja ela de 12 contas ou de 5.000.

O feed não tem filtro "since", então um monitor lê a partir do topo e para no primeiro post que já guardou. Os IDs snowflake, os números que o X dá a cada post, crescem com o tempo, então o ID mais novo que você salvou marca onde a última checagem terminou.

Este loop checa uma Lista a cada cinco minutos e imprime cada post novo uma única vez:

import time
import requests

URL = "https://api.sorsa.io/v3/list-tweets"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
LIST_ID = "1234567890123456789"


def new_posts(seen, max_pages=10):
    """Read the feed from the top until a post we already have."""
    fresh, params = [], {"list_id": LIST_ID}
    for _ in range(max_pages):
        r = requests.get(URL, headers=HEADERS,
                         params=params, timeout=30)
        r.raise_for_status()
        page = r.json()
        for tweet in page.get("tweets", []):
            if tweet["id"] in seen:
                return fresh
            fresh.append(tweet)
        cursor = page.get("next_cursor")
        if not cursor:
            break
        params["next_cursor"] = cursor
    return fresh


seen = set()
while True:
    for t in reversed(new_posts(seen)):
        seen.add(t["id"])
        print(t["created_at"], "@" + t["user"]["username"],
              t["full_text"][:80])
    time.sleep(300)  # check again in 5 minutes

Em produção, guarde o seen em um banco de dados e limite-o aos últimos milhares de IDs. O limite max_pages mantém a primeira execução, quando ainda não há nada armazenado, em 200 posts.

O feed foi feito para o que é novo. Para os posts mais antigos de uma Lista, use a busca: coloque os handles dos membros em operadores from: unidos por OR, em lotes, e envie a consulta ao POST /search-tweets (abre em uma nova aba) com um intervalo de datas. O guia da API de busca do Twitter cobre os operadores, e o histórico vai até 2006.

#Por que uma Lista vale mais do que consultar cada conta

O feed de uma Lista custa uma requisição por checagem, não importa quantas contas ela tenha, enquanto ler a timeline de cada conta custa uma requisição por conta a cada checagem. Para 500 contas checadas a cada 5 minutos, são 4,3 milhões de requisições por mês uma a uma e 8.640 por uma Lista, desde que menos de 20 posts novos cheguem entre as checagens.

A velocidade impõe um segundo limite. A 20 requisições por segundo, uma chave lê 1.200 timelines por minuto, então 5.000 contas levam mais de quatro minutos para uma varredura completa. O feed da Lista responde à mesma pergunta em uma requisição, ou em poucas quando a Lista é movimentada.

As páginas por checagem crescem só com o número de posts novos: cerca de uma requisição para cada 20 posts que chegaram desde a última checagem. Uma Lista acompanha o que contas escolhidas postam. Para captar todo post que cita uma marca, quem quer que o escreva, busque a marca com a API de menções do Twitter.

#Quanto custam os dados de Listas por 1.000

Membros e seguidores de Listas custam a partir de US$ 0,007 por 1.000 na Sorsa API, e os posts de uma Lista, a partir de US$ 0,07 por 1.000. A API oficial do X cobra US$ 10,00 por 1.000 membros ou seguidores e US$ 5,00 por 1.000 posts na lista de preços de pagamento por uso (abre em uma nova aba).

A partir de 22 de novembro de 2026, o X também cobra cada perfil de autor que volta com esses posts, a US$ 0,010 cada (aviso do X de 23 de outubro (abre em uma nova aba)). Na Sorsa API, o perfil do autor faz parte de todo post, sem custo extra.

Cinco fatores decidem uma API de Listas: preço, configuração, taxa de requisições, volume e a segurança da sua conta do X. A Sorsa API sai na frente em todos:

• Membros ou seguidores, por 1.000

  Sorsa API

  a partir de US$ 0,007, 200 por requisição

  API oficial do X

  US$ 10,00, 100 por página

• Posts da Lista, por 1.000

  Sorsa API

  a partir de US$ 0,07, cerca de 20 por requisição

  API oficial do X

  US$ 5,00, mais US$ 0,010 por autor a partir de 22 de nov. de 2026

• Uma Lista cheia, de 5.000 membros

  Sorsa API

  a partir de US$ 0,035

  API oficial do X

  US$ 50,00

• Configuração

  Sorsa API

  uma chave de API

  API oficial do X

  conta de desenvolvedor, app, bearer token, créditos pré-pagos

• Taxa de requisições

  Sorsa API

  20 requisições por segundo em todos os planos

  API oficial do X

  900 requisições a cada 15 minutos por endpoint de Lista

• Teto de volume

  Sorsa API

  planos de até 10 milhões de requisições por mês, mais sob consulta

  API oficial do X

  3 milhões de leituras de posts por ciclo de cobrança, depois Enterprise

• Sua conta do X

  Sorsa API

  nunca é tocada: sem login, sem cookies

  API oficial do X

  sua conta de desenvolvedor e o app dela

Para dados de Listas, use a Sorsa API: membros a 200 por requisição a partir de US$ 0,007 por 1.000, o feed da Lista inteira a partir de US$ 0,07 por 1.000, e nada para configurar além de uma chave. Requisições com falha nunca são cobradas. A Sorsa API é uma API REST: uma requisição com a sua chave retorna JSON limpo, sem nada para rodar no seu navegador e sem pôr em risco a sua conta do X.

#E as Comunidades do X?

O X anunciou em 23 de abril de 2026 que encerraria as Comunidades, primeiro em 6 de maio e depois em 30 de maio, citando pouco uso e spam (TechCrunch (abre em uma nova aba)). O recurso passou das duas datas e ainda estava no ar no fim de julho, sem nova data do X.

A referência da Sorsa API ainda lista cinco endpoints de Comunidades, entre eles o POST /community-tweets (abre em uma nova aba), para os posts de uma Comunidade, e o POST /community-members (abre em uma nova aba), para os membros, além de uma checagem de conta única, o POST /check-community-member (abre em uma nova aba). Nossa documentação pede que você confirme com o suporte quais deles retornam dados antes de montar um fluxo novo sobre eles. As verificações de participação em campanhas estão no guia da API de verificação de engajamento.

Para qualquer coisa que precise continuar funcionando, coloque as contas em uma Lista. As Listas não fazem parte do encerramento, e todos os endpoints de Lista acima as leem hoje.

#Puxe sua primeira Lista

Copie o ID de uma Lista, envie uma requisição ao GET /list-members e até 200 perfis voltam como JSON. A Sorsa API lê os membros e seguidores de uma Lista a 200 por requisição, a partir de US$ 0,007 por 1.000, e o feed inteiro a partir de US$ 0,07 por 1.000, com uma chave e 20 requisições por segundo em todos os planos. Suas 100 requisições grátis exportam 20 mil membros de Listas, quatro Listas cheias, antes de você pagar qualquer coisa.

#FAQ