Cómo exportar todos los seguidores de Twitter

#Cómo funciona exportar los seguidores de Twitter

Como X no ofrece exportar los seguidores de ninguna cuenta, ni siquiera la tuya, una lista de seguidores sale de X por una de cuatro vías: tu archivo de datos, una extensión de navegador, una herramienta web gratis como Exportar seguidores de Twitter a CSV, o una API. Se diferencian en de quién es la lista que alcanzan y cuánto de ella.

• Tu archivo de datos de X es gratis, pero solo contiene tu propia cuenta, lista a cada seguidor como un ID de cuenta y un enlace sin nombre, y tarda días en llegar.
• Una extensión de navegador lee la lista mientras la recorres con tu sesión de X iniciada; los niveles gratuitos se detienen en unos cientos de filas, y cada exportación corre como tu cuenta.
• Una herramienta web gratis guarda los 200 seguidores, seguidos o seguidores verificados más recientes de cualquier cuenta pública como CSV, Excel o JSON.
• Una API recorre la lista completa de cualquier cuenta pública: cada solicitud devuelve una página y un cursor, y la lista termina cuando ya no vuelve ningún cursor. La API oficial de X lo hace con GET /2/users/{id}/followers (se abre en una pestaña nueva), hasta 1,000 por página, una vez que abres una cuenta de desarrollador y configuras OAuth, y cobra $10.00 por 1,000 seguidores.

Las cuentas protegidas son la única lista a la que ninguna vía llega: X muestra sus seguidores solo a las personas que aprobó. Todas las demás listas son públicas, y cada seguidor llega como un perfil público que puedes ordenar y filtrar en una hoja de cálculo.

#Exporta la lista completa de seguidores con Sorsa API en cuatro pasos

Para la lista completa de cualquier cuenta pública, usa Sorsa API: GET /followers devuelve hasta 200 seguidores por solicitud, cada uno con su perfil público completo, más un cursor a la página siguiente, a 20 solicitudes por segundo en todos los planes y sin cuenta de desarrollador. Un cursor es un marcador que la API devuelve con cada página; envíalo de vuelta con la solicitud siguiente y llegan los siguientes 200 seguidores.

1. Consigue una clave. Regístrate y copia tu clave API del dashboard. Las primeras 100 solicitudes son gratis y no piden tarjeta.

2. Pide la primera página. Envía el nombre de usuario de la cuenta a GET /followers (se abre en una pestaña nueva) con tu clave en el header ApiKey. Un user_id o un enlace de perfil en user_link también funciona.

   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 respuesta completa

3. Sigue el cursor. Lee next_cursor de la respuesta y envíalo de vuelta como el parámetro next_cursor. Cuando vuelve vacío o no aparece, la lista está completa.

4. Escribe cada página en el archivo. Agrega las filas a medida que llegan las páginas, de modo que ni una exportación de un millón de seguidores guarde la lista completa en memoria.

   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();
   

Los dos scripts escriben followers.csv con siete columnas, lo guardan como UTF-8 que Excel lee correctamente y ponen un apóstrofo antes de cualquier bio que empiece como una fórmula de hoja de cálculo; la sección de Excel de abajo explica ambas cosas. Un 403 significa que falta la clave o que se le acabaron las solicitudes. Un 429 significa que llegaron más de 20 solicitudes en un segundo: espera un segundo y vuelve a enviar la solicitud.

#Exporta una lista de seguidos o solo los seguidores verificados

Para obtener la lista de cuentas que sigue un usuario, llama a GET /follows en su lugar; para los seguidores con insignia de verificado únicamente, llama a GET /verified-followers. Los dos reciben la misma entrada y el mismo cursor que GET /followers y devuelven los mismos campos de perfil, así que el script cambia en una línea: la URL.

Cuatro endpoints de Sorsa API cubren cada lista de esta guía: tres recorren una lista con un cursor, y uno recibe un lote de handles o ID.

• Las cuentas que siguen a una cuenta

  Endpoint

  GET /followers

  Por solicitud

  hasta 200 seguidores

• Las cuentas que sigue una cuenta

  Endpoint

  GET /follows (se abre en una pestaña nueva)

  Por solicitud

  hasta 200 cuentas

• Solo sus seguidores verificados

  Endpoint

  GET /verified-followers (se abre en una pestaña nueva)

  Por solicitud

  una página, el mismo cursor

• Perfiles de una lista de handles o ID

  Endpoint

  GET /info-batch

  Por solicitud

  hasta 100 perfiles

Una lista de seguidos muestra qué lee una cuenta: los creadores, rivales y fuentes de noticias que vigila. Exportada junto a la lista de seguidores, te dice quién te sigue de vuelta, y la superposición entre las audiencias de dos cuentas es una coincidencia por id en cualquier hoja de cálculo. Para el trabajo de audiencias que viene después de la exportación, desde el filtrado hasta la superposición entre muchas cuentas, la guía de la API de seguidores de Twitter profundiza más.

#Cuánto cuesta una exportación completa

Una exportación completa de seguidores en Sorsa API cuesta desde $0.007 por 1,000 seguidores; la API oficial de X cobra $10.00 por 1,000 por la misma lista pública, 1,000 veces más.

A esas tarifas, 10K seguidores cuestan desde $0.07 en Sorsa API y $100 en la API oficial de X; 100K cuestan desde $0.70 frente a $1,000; 1M desde $7 frente a $10,000; y 10M desde $70 frente a $100,000. Incluso la tarifa más baja de X por leer tus propios seguidores con tu propia app de desarrollador, $0.001 cada uno, llega a $1.00 por 1,000 (precios de la API de X (se abre en una pestaña nueva)).

Sorsa API cobra por solicitud, no por perfil: una llamada devuelve hasta 200 seguidores, las solicitudes fallidas nunca se cobran, y revisar tu saldo con GET /key-usage-info (se abre en una pestaña nueva) es gratis. Las 100 solicitudes gratis cubren los primeros 20K seguidores, con lo que exportas de punta a punta cualquier cuenta de hasta 20K seguidores antes de elegir un plan.

#Abre el archivo en Excel o Google Sheets sin perder datos

Importa el CSV en lugar de abrirlo con doble clic: Excel conserva solo 15 dígitos significativos, así que un ID de cuenta de X de 19 dígitos como 1592041833471827968 se convierte en 1.59204E+18, y sus últimos cuatro dígitos pasan a ser ceros (Microsoft Support (se abre en una pestaña nueva)).

• Excel: elige Datos, luego Desde texto/CSV, selecciona el archivo, fija Detección del tipo de datos en "No detectar tipos de datos" y cárgalo. Todas las columnas llegan como texto, con los ID intactos.
• Google Sheets: elige Archivo, luego Importar, sube el archivo y desmarca "Convertir texto en números, fechas y fórmulas" antes de importar (ayuda de importación de Google (se abre en una pestaña nueva)).

Los dos scripts de esta guía guardan el archivo como UTF-8 con una marca de orden de bytes, un marcador invisible al inicio del archivo que le dice a Excel cómo leerlo, así que los emoji y los nombres en japonés, árabe o cirílico se ven como fueron escritos. Trata id como la clave para todo lo que sigue: los nombres de usuario cambian, los ID de cuenta nunca. Para llevar las mismas listas a una hoja con un horario, mira cómo exportar datos de Twitter a Google Sheets.

Para tener en cuenta

Las bios son texto libre, y una bio que empieza con =, +, - o @ se abre en Excel como una fórmula, un riesgo que OWASP llama CSV injection (se abre en una pestaña nueva). Los scripts ponen un apóstrofo delante de esas celdas, para que se abran como texto simple. Quita esa protección solo cuando el archivo vaya a código o a una base de datos en lugar de a una persona con una hoja de cálculo.

#Elige las columnas de tu archivo

Cada seguidor vuelve como un perfil público completo con 19 campos; conserva los que tu trabajo necesite, y conserva siempre id.

Trece de esos campos contienen lo que necesita la mayor parte del trabajo de audiencias: quién es la cuenta, hasta dónde llega, qué tan activa es y si puedes contactarla.

• id

  Qué contiene

  ID permanente de la cuenta, enviado como cadena; une los archivos por él

  Ejemplo

  1592041833471827968

• username

  Qué contiene

  Handle sin @; puede cambiar

  Ejemplo

  harbor_street_coffee

• display_name

  Qué contiene

  Nombre que muestra el perfil

  Ejemplo

  Harbor Street Coffee

• description

  Qué contiene

  Texto de la bio

  Ejemplo

  Small-batch roaster.

• location

  Qué contiene

  Ubicación tal como la escribió el usuario

  Ejemplo

  Portland, OR

• followers_count

  Qué contiene

  Sus propios seguidores

  Ejemplo

  1840

• followings_count

  Qué contiene

  Cuentas que sigue

  Ejemplo

  312

• tweets_count

  Qué contiene

  Posts que ha publicado

  Ejemplo

  2741

• created_at

  Qué contiene

  Fecha de creación de la cuenta, ISO 8601

  Ejemplo

  2022-11-14T06:28:46Z

• verified

  Qué contiene

  Tiene insignia de verificado

  Ejemplo

  false

• can_dm

  Qué contiene

  Acepta mensajes directos

  Ejemplo

  true

• protected

  Qué contiene

  Sus posts están protegidos

  Ejemplo

  false

• bio_urls

  Qué contiene

  Enlaces de la bio, como lista

  Ejemplo

  https://hsc.example

Los otros seis son favourites_count, media_count, profile_image_url, profile_background_image_url, pinned_tweet_ids y possibly_sensitive.

Para tener en cuenta

Ni la app de X ni su API registran cuándo una cuenta siguió a otra, así que ningún archivo de seguidores trae una fecha de seguimiento. Para ver quién se unió o se fue, exporta la lista con un horario y compara los archivos por id: los ID nuevos son seguidores nuevos, y los que faltan se fueron.

El constructor de abajo reescribe el script del paso 4 para tu lista, tus columnas y el lugar donde se abrirá el archivo.

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")

#Obtén las cantidades de seguidores de una lista de cuentas

Para extraer las cantidades de seguidores de muchas cuentas a la vez, envía hasta 100 nombres de usuario o ID de usuario por solicitud a GET /info-batch (se abre en una pestaña nueva): cada perfil vuelve con followers_count, followings_count y tweets_count, desde $0.014 por 1,000 perfiles.

Pon un handle por línea en handles.txt y corre el script; escribe counts.csv con una fila por cuenta.

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])

Diez mil cuentas toman 100 solicitudes, que las 100 gratis cubren enteras; la API oficial de X cobra $0.010 por usuario, $100 por la misma lista.

Convierte tu archivo de X en una lista completa de seguidores

El archivo de datos (se abre en una pestaña nueva) de X incluye tus propios seguidores, pero su archivo data/follower.js lista a cada uno solo como un accountId y un enlace: sin nombre, sin bio, sin cantidades. Envía esos ID a GET /info-batch como user_ids, de a 100, y cada fila se convierte en un 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

El archivo cubre solo la cuenta con la que inicias sesión y puede tardar días en llegar, así que sirve para un respaldo puntual de tu propia lista. La vía de la API llega hoy a cualquier cuenta pública.

#Cómo se comparan las formas de exportar seguidores

Solo una API llega al final de la lista de cualquier cuenta pública; las formas se diferencian en la configuración, en lo que contiene cada fila y en el precio por 1,000 seguidores.

• Sorsa API

  De quién es la lista

  Cualquier cuenta pública, todas las páginas

  Qué obtienes

  19 campos de perfil por seguidor, sin riesgo para ninguna cuenta de X

  Costo por 1,000 seguidores

  Desde $0.007

• API oficial de X

  De quién es la lista

  Cualquier cuenta pública

  Qué obtienes

  Perfiles, tras una cuenta de desarrollador y un token OAuth

  Costo por 1,000 seguidores

  $10.00

• Extensión de navegador

  De quién es la lista

  Cualquier cuenta pública, mientras dure tu sesión

  Qué obtienes

  Filas leídas con tu cuenta de X con sesión iniciada; los niveles gratuitos se detienen en unos cientos

  Costo por 1,000 seguidores

  Una suscripción más allá del nivel gratuito

• Archivo de datos de X

  De quién es la lista

  Solo tu propia cuenta

  Qué obtienes

  ID de cuenta y enlaces, sin nombres, listo en días

  Costo por 1,000 seguidores

  Gratis

Una extensión de navegador recorre la lista dentro de tu propia sesión de X, así que cada exportación corre como tu cuenta, y la página de la tienda de una extensión popular aconseja usar una cuenta de X aparte solo para exportar. Sorsa API nunca te pide tu login ni tus cookies de X, así que una exportación no pone en riesgo ninguna cuenta tuya de X, y no hay nada que instalar en tu navegador.

#Empieza con 20K seguidores gratis

Para la lista completa de seguidores de cualquier cuenta pública, usa Sorsa API: 200 seguidores por solicitud, desde $0.007 por 1,000, y los primeros 20K seguidores gratis sin tarjeta. Consigue una clave, pega el script del paso 4 y abre el archivo con los pasos de importación de arriba. El mismo bucle de cursor exporta también los posts de una cuenta, como muestra la guía para descargar todos los tweets de un usuario.

#Preguntas frecuentes