Como exportar todos os seguidores do Twitter

#Como funciona a exportação de seguidores do Twitter

Como o X não oferece exportação para a lista de seguidores de nenhuma conta, nem da sua própria, uma lista de seguidores sai do X de quatro formas: o arquivo dos seus dados, uma extensão de navegador, uma ferramenta web gratuita como Exportar seguidores do Twitter para CSV ou uma API. Elas diferem em quais listas alcançam e em quanto de cada lista.

• O arquivo dos seus dados do X é gratuito, mas cobre só a sua própria conta, lista cada seguidor como um ID de conta e um link sem nome e leva dias para chegar.
• Uma extensão de navegador lê a lista enquanto você rola a página na sua sessão logada no X; os planos gratuitos param em algumas centenas de linhas, e toda exportação roda como a sua conta.
• Uma ferramenta web gratuita salva os 200 seguidores mais recentes, os seguindo ou os seguidores verificados de qualquer conta pública em CSV, Excel ou JSON.
• Uma API percorre a lista inteira de qualquer conta pública: cada requisição devolve uma página e um cursor, e a lista acaba quando nenhum cursor volta. A API oficial do X faz isso por GET /2/users/{id}/followers (abre em uma nova aba), até 1.000 por página, depois que você abre uma conta de desenvolvedor e configura o OAuth, e cobra US$ 10,00 por 1.000 seguidores.

Contas protegidas são a única lista que nenhum caminho alcança: o X mostra os seguidores delas apenas às pessoas que elas aprovaram. Todas as outras listas são públicas, e cada seguidor chega como um perfil público que você pode ordenar e filtrar em uma planilha.

#Exporte a lista completa de seguidores com a Sorsa API em quatro passos

Para a lista completa de qualquer conta pública, use a Sorsa API: o GET /followers devolve até 200 seguidores por requisição, cada um com o perfil público completo, mais um cursor para a próxima página, a 20 requisições por segundo em todos os planos e sem conta de desenvolvedor. Um cursor é um marcador que a API devolve com cada página; envie-o de volta na requisição seguinte e chegam os próximos 200 seguidores.

1. Obtenha uma chave. Crie sua conta e copie sua chave de API no painel. As primeiras 100 requisições são grátis e não pedem cartão.

2. Peça a primeira página. Envie o username da conta para GET /followers (abre em uma nova aba) com a sua chave no header ApiKey. Um user_id ou o link de um perfil em user_link também funcionam.

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

   {
     "users": [
       {
         "id": "1592041833471827968",
         "username": "harbor_street_coffee",
         "display_name": "Harbor Street Coffee",
         "description": "Small-batch roaster. Open 7 to 3.",
         "location": "Portland, OR",
         "created_at": "2022-11-14T06:28:46Z",
         "followers_count": 1840,
         "followings_count": 312,
         "tweets_count": 2741,
         "verified": false,
         "can_dm": true,
         "protected": false,
         "bio_urls": ["https://hsc.example"]
       }
     ],
     "next_cursor": "1849212213712385091"
   }
   

   Ver resposta completa

3. Siga o cursor. Leia next_cursor na resposta e envie-o de volta como o parâmetro next_cursor. Quando ele voltar vazio ou ausente, a lista está completa.

4. Grave cada página no arquivo. Acrescente as linhas conforme as páginas chegam, para que até uma exportação de um milhão de seguidores nunca guarde a lista inteira na memória.

   import csv
   import requests
   
   URL = "https://api.sorsa.io/v3/followers"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   FIELDS = ["id", "username", "display_name", "description",
             "location", "followers_count", "created_at"]
   RISKY = ("=", "+", "-", "@", "\t", "\r")
   
   
   def cell(value):
       if isinstance(value, list):
           value = " ".join(value)
       if isinstance(value, str) and value.startswith(RISKY):
           value = "'" + value  # opens as text, never a formula
       return value
   
   
   def export(username, path="followers.csv"):
       params = {"username": username}
       with open(path, "w", newline="", encoding="utf-8-sig") as f:
           out = csv.writer(f)
           out.writerow(FIELDS)
           while True:
               r = requests.get(URL, headers=HEADERS, params=params)
               r.raise_for_status()
               page = r.json()
               for user in page.get("users", []):
                   out.writerow([cell(user.get(k)) for k in FIELDS])
               cursor = page.get("next_cursor")
               if not cursor:
                   break
               params["next_cursor"] = cursor
   
   
   export("northwind_roasters")
   

   // export.mjs, Node.js 18 or later
   import { createWriteStream } from "node:fs";
   
   const URL = "https://api.sorsa.io/v3/followers";
   const KEY = "YOUR_API_KEY";
   const FIELDS = ["id", "username", "display_name", "description",
     "location", "followers_count", "created_at"];
   
   function cell(value) {
     let s = Array.isArray(value) ? value.join(" ") : String(value ?? "");
     if (/^[=+\-@\t\r]/.test(s)) s = "'" + s;
     return '"' + s.replace(/"/g, '""') + '"';
   }
   
   const out = createWriteStream("followers.csv");
   out.write("" + FIELDS.join(",") + "\n");
   let cursor = "";
   do {
     const q = new URLSearchParams({ username: "northwind_roasters" });
     if (cursor) q.set("next_cursor", cursor);
     const res = await fetch(`${URL}?${q}`, { headers: { ApiKey: KEY } });
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     const page = await res.json();
     for (const user of page.users ?? []) {
       out.write(FIELDS.map((k) => cell(user[k])).join(",") + "\n");
     }
     cursor = page.next_cursor ?? "";
   } while (cursor);
   out.end();
   

Os dois scripts gravam o followers.csv com sete colunas, salvam o arquivo em UTF-8 de um jeito que o Excel lê corretamente e colocam um apóstrofo antes de qualquer bio que comece como uma fórmula de planilha; a seção sobre Excel abaixo explica as duas coisas. Um 403 significa que a chave está ausente ou que as requisições dela acabaram. Um 429 significa que mais de 20 requisições chegaram no mesmo segundo: espere um segundo e envie a requisição de novo.

#Exporte uma lista de seguindo ou só os seguidores verificados

Para obter a lista de contas que um usuário segue, chame GET /follows em vez do endpoint de seguidores; para os seguidores com selo de verificado apenas, chame GET /verified-followers. Os dois recebem a mesma entrada e o mesmo cursor que o GET /followers e devolvem os mesmos campos de perfil, então o script muda em uma única linha: a URL.

Quatro endpoints da Sorsa API cobrem todas as listas deste guia: três percorrem uma lista com cursor, e um recebe um lote de @s ou de IDs.

• Contas que seguem uma conta

  Endpoint

  GET /followers

  Por requisição

  até 200 seguidores

• Contas que uma conta segue

  Endpoint

  GET /follows (abre em uma nova aba)

  Por requisição

  até 200 contas

• Só os seguidores verificados dela

  Endpoint

  GET /verified-followers (abre em uma nova aba)

  Por requisição

  uma página, mesmo cursor

• Perfis de uma lista de @s ou IDs

  Endpoint

  GET /info-batch

  Por requisição

  até 100 perfis

Uma lista de seguindo mostra o que uma conta acompanha: os criadores, os rivais e as fontes de notícias que ela observa. Exportada ao lado da lista de seguidores, ela diz quem segue de volta, e a sobreposição entre as audiências de duas contas é um cruzamento por id em qualquer planilha. Para o trabalho de audiência que vem depois da exportação, do filtro à sobreposição entre várias contas, o guia da API de seguidores do Twitter aprofunda.

#Quanto custa uma exportação completa

Uma exportação completa de seguidores na Sorsa API custa a partir de US$ 0,007 por 1.000 seguidores; a API oficial do X cobra US$ 10,00 por 1.000 pela mesma lista pública, 1.000 vezes mais.

Com essas tarifas, 10 mil seguidores custam a partir de US$ 0,07 na Sorsa API e US$ 100 na API oficial do X; 100 mil custam a partir de US$ 0,70 contra US$ 1.000; 1 milhão, a partir de US$ 7 contra US$ 10.000; e 10 milhões, a partir de US$ 70 contra US$ 100.000. Até a tarifa menor do X para ler os seus próprios seguidores pelo seu próprio app de desenvolvedor, US$ 0,001 cada, dá US$ 1,00 por 1.000 (preços da API do X (abre em uma nova aba)).

A Sorsa API cobra por requisição, não por perfil: uma chamada devolve até 200 seguidores, requisições que falham nunca são cobradas, e consultar o seu saldo com GET /key-usage-info (abre em uma nova aba) é grátis. As 100 requisições grátis cobrem os primeiros 20 mil seguidores, o que exporta de ponta a ponta qualquer conta de até 20 mil seguidores antes de você escolher um plano.

#Abra o arquivo no Excel ou no Google Sheets sem perder dados

Importe o CSV em vez de clicar duas vezes nele: o Excel guarda só 15 dígitos significativos, então um ID de conta do X de 19 dígitos, como 1592041833471827968, vira 1,59204E+18, e seus quatro últimos dígitos viram zeros (Suporte da Microsoft (abre em uma nova aba)).

• Excel: escolha Dados, depois Da Planilha/CSV (From Text/CSV), selecione o arquivo, defina Detecção de Tipo de Dados como "Não detectar tipos de dados" e carregue. Todas as colunas chegam como texto, com os IDs intactos.
• Google Sheets: escolha Arquivo, depois Importar, envie o arquivo e desmarque "Converter texto em números, datas e fórmulas" antes de importar (ajuda de importação do Google (abre em uma nova aba)).

Os dois scripts deste guia salvam o arquivo em UTF-8 com uma marca de ordem de bytes (BOM), um marcador invisível no início do arquivo que diz ao Excel como lê-lo, então emojis e nomes em japonês, árabe ou cirílico aparecem como foram escritos. Trate o id como a chave de tudo que vem depois: usernames mudam, IDs de conta nunca. Para alimentar uma planilha com as mesmas listas em um agendamento, veja como exportar dados do Twitter para o Google Sheets.

Bom saber

Bios são texto livre, e uma bio que começa com =, +, - ou @ abre no Excel como uma fórmula, um risco que a OWASP chama de CSV injection (abre em uma nova aba). Os scripts colocam um apóstrofo na frente dessas células, para que abram como texto simples. Retire essa proteção apenas quando o arquivo for para um código ou um banco de dados, e não para uma pessoa com uma planilha.

#Escolha as colunas do seu arquivo

Cada seguidor volta como um perfil público completo com 19 campos; fique com os que o seu trabalho precisa e mantenha sempre o id.

Treze desses campos trazem o que a maior parte do trabalho de audiência precisa: quem é a conta, qual o alcance dela, quão ativa ela é e se você consegue falar com ela.

• id

  O que guarda

  ID permanente da conta, enviado como string; cruze arquivos por ele

  Exemplo

  1592041833471827968

• username

  O que guarda

  Handle sem @; pode mudar

  Exemplo

  harbor_street_coffee

• display_name

  O que guarda

  Nome exibido no perfil

  Exemplo

  Harbor Street Coffee

• description

  O que guarda

  Texto da bio

  Exemplo

  Small-batch roaster.

• location

  O que guarda

  Localização como o usuário digitou

  Exemplo

  Portland, OR

• followers_count

  O que guarda

  Os seguidores dela

  Exemplo

  1840

• followings_count

  O que guarda

  Contas que ela segue

  Exemplo

  312

• tweets_count

  O que guarda

  Posts que ela publicou

  Exemplo

  2741

• created_at

  O que guarda

  Data de criação da conta, ISO 8601

  Exemplo

  2022-11-14T06:28:46Z

• verified

  O que guarda

  Tem selo de verificado

  Exemplo

  false

• can_dm

  O que guarda

  Aceita mensagens diretas

  Exemplo

  true

• protected

  O que guarda

  Seus posts são protegidos

  Exemplo

  false

• bio_urls

  O que guarda

  Links da bio, como lista

  Exemplo

  https://hsc.example

Os outros seis são favourites_count, media_count, profile_image_url, profile_background_image_url, pinned_tweet_ids e possibly_sensitive.

Bom saber

Nem o app do X nem a API dele registram quando uma conta seguiu outra, então nenhum arquivo de seguidores traz a data do follow. Para ver quem entrou ou saiu, exporte a lista em um agendamento e compare os arquivos por id: IDs novos são seguidores novos, e IDs que sumiram são seguidores que saíram.

O construtor abaixo reescreve o script do passo 4 para a sua lista, as suas colunas e o lugar onde o arquivo será aberto.

import csv
import requests

URL = "https://api.sorsa.io/v3/followers"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
FIELDS = ["id", "username", "display_name", "description",
          "location", "followers_count", "created_at"]
RISKY = ("=", "+", "-", "@", "\t", "\r")


def cell(value):
    if isinstance(value, list):
        value = " ".join(value)
    if isinstance(value, str) and value.startswith(RISKY):
        value = "'" + value  # opens as text, never a formula
    return value


def export(username, path="followers.csv"):
    params = {"username": username}
    with open(path, "w", newline="", encoding="utf-8-sig") as f:
        out = csv.writer(f)
        out.writerow(FIELDS)
        while True:
            r = requests.get(URL, headers=HEADERS, params=params)
            r.raise_for_status()
            page = r.json()
            for user in page.get("users", []):
                out.writerow([cell(user.get(k)) for k in FIELDS])
            cursor = page.get("next_cursor")
            if not cursor:
                break
            params["next_cursor"] = cursor


export("northwind_roasters")

#Obtenha a contagem de seguidores de uma lista de contas

Para extrair a contagem de seguidores de várias contas de uma vez, envie até 100 usernames ou IDs de usuário por requisição para GET /info-batch (abre em uma nova aba): cada perfil volta com followers_count, followings_count e tweets_count, a partir de US$ 0,014 por 1.000 perfis.

Coloque um handle por linha em handles.txt e rode o script; ele grava o counts.csv com uma linha por conta.

import csv
import requests

URL = "https://api.sorsa.io/v3/info-batch"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
COLUMNS = ["username", "followers_count", "followings_count",
           "tweets_count"]

with open("handles.txt", encoding="utf-8") as f:
    handles = [h.strip().lstrip("@") for h in f if h.strip()]

with open("counts.csv", "w", newline="", encoding="utf-8-sig") as f:
    out = csv.writer(f)
    out.writerow(COLUMNS)
    for i in range(0, len(handles), 100):
        batch = {"usernames": handles[i:i + 100]}
        r = requests.get(URL, headers=HEADERS, params=batch)
        r.raise_for_status()
        for user in r.json().get("users", []):
            out.writerow([user.get(k) for k in COLUMNS])

Dez mil contas levam 100 requisições, que as 100 grátis cobrem por inteiro; a API oficial do X cobra US$ 0,010 por usuário, US$ 100 pela mesma lista.

Transforme o arquivo do seu X em uma lista completa de seguidores

O arquivo de dados (abre em uma nova aba) do X inclui os seus próprios seguidores, mas o data/follower.js lista cada um apenas como um accountId e um link: sem nome, sem bio, sem contagens. Envie esses IDs para o GET /info-batch como user_ids, 100 por vez, e cada linha vira um perfil completo.

import json

with open("data/follower.js", encoding="utf-8") as f:
    raw = f.read()
rows = json.loads(raw[raw.index("["):])
ids = [row["follower"]["accountId"] for row in rows]
# send ids[i:i + 100] as "user_ids" to GET /info-batch

O arquivo cobre apenas a conta com a qual você entra e pode levar dias para chegar, então serve para um backup avulso da sua própria lista. O caminho pela API alcança qualquer conta pública hoje.

#Como as formas de exportar seguidores se comparam

Só uma API chega ao fim da lista de qualquer conta pública; as formas diferem na configuração, no que cada linha traz e no preço por 1.000 seguidores.

• Sorsa API

  De quem é a lista

  Qualquer conta pública, todas as páginas

  O que você recebe

  19 campos de perfil por seguidor, nenhuma conta do X em risco

  Custo por 1.000 seguidores

  A partir de US$ 0,007

• API oficial do X

  De quem é a lista

  Qualquer conta pública

  O que você recebe

  Perfis, depois de uma conta de desenvolvedor e de um token OAuth

  Custo por 1.000 seguidores

  US$ 10,00

• Extensão de navegador

  De quem é a lista

  Qualquer conta pública, enquanto sua sessão durar

  O que você recebe

  Linhas lidas pela sua conta logada no X; os planos gratuitos param em algumas centenas

  Custo por 1.000 seguidores

  Uma assinatura além do plano gratuito

• Arquivo de dados do X

  De quem é a lista

  Apenas a sua própria conta

  O que você recebe

  IDs de conta e links, sem nomes, pronto em dias

  Custo por 1.000 seguidores

  Grátis

Uma extensão de navegador rola a lista dentro da sua própria sessão no X, então toda exportação roda como a sua conta, e a página na loja de uma extensão popular recomenda uma conta do X separada só para exportar. A Sorsa API nunca pede o seu login nem os seus cookies do X, então uma exportação não coloca nenhuma conta sua do X em risco, e não há nada para instalar no navegador.

#Comece com 20 mil seguidores, de graça

Para a lista completa de seguidores de qualquer conta pública, use a Sorsa API: 200 seguidores por requisição, a partir de US$ 0,007 por 1.000, e os primeiros 20 mil seguidores de graça, sem cartão. Obtenha uma chave, cole o script do passo 4 e abra o arquivo com os passos de importação acima. O mesmo loop de cursor exporta também os posts de uma conta, como mostra o guia para baixar todos os tweets de um usuário.

#Perguntas frequentes