API de ubicación de Twitter: seguidores por país

#Cómo ver de dónde son los seguidores de una cuenta de Twitter

X no dibuja ningún mapa de seguidores para las cuentas de otras personas, y sus propias analíticas vienen con X Premium y cubren solo la audiencia del propio suscriptor. Lo que X sí muestra en los perfiles públicos es el país en el que ubica a cada cuenta, y el Buscador de ubicación de cuentas de Twitter gratuito lo lee para una cuenta. Repite eso para una audiencia y tendrás su geografía, construida con dos datos públicos que X conserva:

1. La lista de seguidores. Los seguidores de cualquier cuenta pública se pueden leer página por página, de los más recientes a los más antiguos.

2. El país de cada seguidor. Desde noviembre de 2025, los perfiles públicos tienen un panel Acerca de esta cuenta, que se abre desde la fecha de registro, con una línea "Cuenta con sede en" (Account based in). X la rellena a partir de las direcciones IP agregadas de la cuenta, según su Centro de ayuda (se abre en una pestaña nueva), no con nada que escriba el dueño.

Cuenta esos países entre los seguidores y las proporciones son la geografía de la audiencia, de tu propia cuenta o de la de cualquier otra persona, en una tabla que puedes exportar y comparar. Para saber qué significa la etiqueta y cuándo falla, lee qué significa "Cuenta con sede en" en X.

La ubicación de la bio es la trampa. Es texto libre y opcional, y el propio diccionario de datos para desarrolladores (se abre en una pestaña nueva) de X advierte que "puede no indicar una ubicación válida". Un mapa construido con ella descarta a quienes la dejaron vacía o escribieron "Earth", y cuenta al resto por lo que decidieron escribir.

#Mapea los seguidores por país con Sorsa API en seis pasos

Sorsa API, una API y scraper de Twitter (X), devuelve los dos datos: GET /followers (se abre en una pestaña nueva) lista los seguidores de cualquier cuenta pública, 200 por solicitud, y GET /about (se abre en una pestaña nueva) devuelve el país que X asigna a una cuenta por solicitud. Para mapear una audiencia por país, usa Sorsa API: una sola clave de API, sin cuenta de desarrollador de X, y el país de cada seguidor desde $1.40 por 1,000 cuentas.

1. Obtén una clave. Regístrate y copia tu clave de API desde el panel. Las cuentas nuevas reciben 100 solicitudes gratis, sin tarjeta.

2. Revisa una cuenta. Envía un nombre de usuario a GET /about. El campo country contiene el valor de "Cuenta con sede en".

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

   {
     "country": "Portugal",
     "source": "Portugal App Store",
     "username_change_count": 1,
     "last_username_change_at": "2019-05-14T09:12:40Z",
     "is_blue_verified": true,
     "premium_start_at": "2024-01-08T17:03:11Z",
     "affiliate_username": null
   }
   

3. Lista los seguidores. Recorre GET /followers y devuelve cada next_cursor hasta que no llegue ninguno. Guarda el id de cada seguidor: una cuenta de 1M de seguidores necesita 5K solicitudes.

4. Toma una muestra aleatoria. Elige 1,000 IDs al azar de toda la lista, no de las primeras páginas, que solo contienen a los seguidores más recientes.

5. Consulta cada país. Llama a GET /about con user_id para cada seguidor de la muestra, a hasta 20 solicitudes por segundo.

6. Cuenta las proporciones. Agrupa las respuestas por país, conserva "Unknown" y los nombres de regiones como filas propias, y divide cada conteo entre el tamaño de la muestra.

El script de abajo ejecuta los seis pasos e imprime la proporción de cada país con su margen. Un estado 429 significa más de 20 solicitudes en un segundo, así que espera y reintenta; un 403 significa que falta la clave o que se agotaron las solicitudes.

import random
import time
from collections import Counter
from math import sqrt

import requests

API = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": "YOUR_API_KEY"}


def follower_ids(username):
    """Every follower's ID, 200 per request, newest first."""
    ids, params = [], {"username": username}
    while True:
        r = requests.get(f"{API}/followers", headers=HEADERS, params=params)
        r.raise_for_status()
        page = r.json()
        ids += [u["id"] for u in page.get("users", [])]
        cursor = page.get("next_cursor")
        if not cursor:
            return ids
        params["next_cursor"] = cursor


def country(user_id):
    """The country X assigns to one account, or Unknown."""
    r = requests.get(f"{API}/about", headers=HEADERS,
                     params={"user_id": user_id})
    if r.status_code == 429:  # over 20 requests in a second
        time.sleep(1)
        return country(user_id)
    if not r.ok:
        return "Unknown"
    return r.json().get("country") or "Unknown"


def geography(username, sample_size=1000):
    ids = follower_ids(username)
    sample = random.sample(ids, min(sample_size, len(ids)))
    counts = Counter()
    for user_id in sample:
        counts[country(user_id)] += 1
        time.sleep(0.05)  # one lookup at a time stays under 20 per second
    n = len(sample)
    for name, k in counts.most_common(15):
        p = k / n
        margin = 1.96 * sqrt(p * (1 - p) / n)
        print(f"{name:<24} {p:6.1%}  +/- {margin:.1%}")


geography("lisbon_tile_workshop")

const API = "https://api.sorsa.io/v3";
const headers = { ApiKey: "YOUR_API_KEY" };
const sleep = (ms) => new Promise((done) => setTimeout(done, ms));

async function followerIds(username) {
  const ids = [];
  let cursor = null;
  do {
    const params = new URLSearchParams({ username });
    if (cursor) params.set("next_cursor", cursor);
    const res = await fetch(`${API}/followers?${params}`, { headers });
    if (!res.ok) throw new Error(`followers: HTTP ${res.status}`);
    const page = await res.json();
    for (const u of page.users ?? []) ids.push(u.id);
    cursor = page.next_cursor;
  } while (cursor);
  return ids;
}

async function country(userId) {
  const res = await fetch(`${API}/about?user_id=${userId}`, { headers });
  if (res.status === 429) {
    await sleep(1000);
    return country(userId);
  }
  if (!res.ok) return "Unknown";
  return (await res.json()).country || "Unknown";
}

async function geography(username, sampleSize = 1000) {
  const ids = await followerIds(username);
  for (let i = ids.length - 1; i > 0; i--) {
    const j = Math.floor(Math.random() * (i + 1));
    [ids[i], ids[j]] = [ids[j], ids[i]];
  }
  const sample = ids.slice(0, sampleSize);
  const counts = new Map();
  for (const id of sample) {
    const c = await country(id);
    counts.set(c, (counts.get(c) ?? 0) + 1);
    await sleep(50);
  }
  const rows = [...counts].sort((a, b) => b[1] - a[1]).slice(0, 15);
  for (const [name, k] of rows) {
    const p = k / sample.length;
    const margin = 1.96 * Math.sqrt((p * (1 - p)) / sample.length);
    const share = (p * 100).toFixed(1);
    const plusMinus = (margin * 100).toFixed(1);
    console.log(`${name.padEnd(24)} ${share}%  +/- ${plusMinus}%`);
  }
}

geography("lisbon_tile_workshop");

Para una lista que ya tienes, como una exportación de seguidores de Twitter o un CSV con los usuarios de tus clientes, omite el paso 3 y envía esos IDs o nombres de usuario directamente a GET /about.

#Los tres lugares donde X guarda la ubicación de una cuenta

Una cuenta de X puede llevar tres tipos de ubicación, y solo uno viene de la propia X: el país de "Cuenta con sede en". Ese es el que hay que contar para la geografía de una audiencia, porque es el único que fija X y el único con una sola respuesta por cuenta.

La tabla muestra quién fija cada señal y dónde la lee una API.

• Cuenta con sede en

  Quién la fija

  X, a partir de direcciones IP agregadas

  Qué contiene

  Un país, o una región que el dueño eligió mostrar

  Dónde la lee una API

  country de GET /about en Sorsa API; ausente en la API oficial de X

• Ubicación de la bio

  Quién la fija

  El dueño, como texto libre

  Qué contiene

  Una ciudad, una broma o nada

  Dónde la lee una API

  location en cada perfil, en ambas APIs

• Lugar en un post

  Quién la fija

  El autor, post por post

  Qué contiene

  Una zona o un local con nombre

  Dónde la lee una API

  Solo en los posts cuyos autores etiquetaron uno

La API oficial de X lleva solo la ubicación de la bio para las cuentas: su objeto de usuario tiene el location escrito a mano y ningún campo de país. Leer seguidores allí cuesta $0.010 cada uno según la lista de precios de pago por uso de X (se abre en una pestaña nueva), así que una lista de 1M de seguidores cuesta $10,000 y aun así termina en texto libre.

Los lugares en los posts responden a otra pregunta: dónde se publicó algo, no dónde tiene su sede una cuenta. Un post lleva uno solo después de que su autor activa la ubicación en la app y añade un lugar, como describe el Centro de ayuda de X (se abre en una pestaña nueva), así que la mayoría de los posts no llevan ninguno. Para encontrar posts de una ciudad, usa los operadores near: y within: de la guía de operadores de búsqueda de Twitter.

#A cuántos seguidores tienes que revisar

Una muestra aleatoria de 1,000 seguidores deja la proporción de cada país dentro de unos 3.1 puntos porcentuales, 95 veces de cada 100, sea que la cuenta tenga 50K seguidores o 50M. El margen depende de a cuántos seguidores revisas, no de cuántos tiene la cuenta, y por eso una muestra supera a un censo en las cuentas grandes.

Los márgenes de abajo corresponden a una muestra aleatoria simple con 95% de confianza. Un país que concentra cerca de la mitad de la audiencia tiene el margen más amplio; los países más pequeños se conocen con más precisión.

• 400

  Margen en una proporción de 50%

  ±4.9 puntos

  Margen en una proporción de 10%

  ±2.9 puntos

• 1,000

  Margen en una proporción de 50%

  ±3.1 puntos

  Margen en una proporción de 10%

  ±1.9 puntos

• 2,000

  Margen en una proporción de 50%

  ±2.2 puntos

  Margen en una proporción de 10%

  ±1.3 puntos

• 5,000

  Margen en una proporción de 50%

  ±1.4 puntos

  Margen en una proporción de 10%

  ±0.8 puntos

• Todos los seguidores

  Margen en una proporción de 50%

  ninguno

  Margen en una proporción de 10%

  ninguno

Dos reglas mantienen honesta la muestra. Tómala de toda la lista de seguidores, ya que las primeras páginas contienen solo a los seguidores más recientes. Y dimensiónala según la pregunta: 1,000 distinguen un mercado de 30% de uno de 20%, mientras que distinguir un país de 6% de uno de 4% necesita unos 5,000.

Para tener en cuenta

Los seguidores más recientes describen el crecimiento reciente, no la audiencia. Esa diferencia es útil por sí sola: compara los países de los 1,000 seguidores más recientes con 1,000 al azar de toda la lista, y un bloque repentino de un país inesperado salta a la vista de inmediato. Una oleada así es una señal común de seguidores comprados, un tema que cubre a fondo la detección de bots en Twitter.

#Cuánto cuesta mapear una audiencia por país

En Sorsa API, mapear una audiencia de 1M de seguidores a partir de una muestra de 1,000 cuesta desde $8.40: $7.00 para listar a todos los seguidores y $1.40 para los 1,000 países. Revisar a todos los seguidores cuesta en cambio desde $1,407. La API oficial de X cobra $10,000 solo por la lista de seguidores, y sus datos no tienen ningún país que contar.

En las cuentas grandes, la muestra cuesta casi nada comparada con el listado, y el listado cuesta casi nada comparado con un censo. Los precios de Sorsa API de abajo usan su tarifa más baja, $1.40 por 1,000 solicitudes.

• 10K

  Sorsa API, 1,000 revisados

  desde $1.47

  Sorsa API, todos los seguidores

  desde $14.07

  API oficial de X, solo la lista

  $100

• 100K

  Sorsa API, 1,000 revisados

  desde $2.10

  Sorsa API, todos los seguidores

  desde $140.70

  API oficial de X, solo la lista

  $1,000

• 1M

  Sorsa API, 1,000 revisados

  desde $8.40

  Sorsa API, todos los seguidores

  desde $1,407

  API oficial de X, solo la lista

  $10,000

• 10M

  Sorsa API, 1,000 revisados

  desde $71.40

  Sorsa API, todos los seguidores

  desde $14,070

  API oficial de X, solo la lista

  $100,000

El tiempo sigue la misma división. A 20 solicitudes por segundo en todos los planes de Sorsa API, 1,000 consultas de país terminan en menos de un minuto, mientras que revisar a todos los 1M de seguidores de una cuenta grande toma unas 14 horas a esa tasa con una sola clave. Con los $4.90 por 1,000 solicitudes del plan Starter, la muestra de la cuenta de 1M de seguidores cuesta $29.40.

#Cómo leer el resultado

Una tabla de países es tan buena como las filas que dejas fuera de ella. Cinco cosas deciden cómo leerla:

• Unknown. X no muestra país para algunas cuentas, incluidas las cuentas de gobierno con verificación gris, y Sorsa API devuelve "Unknown" cuando X tiene muy pocos datos. Repórtalo como una fila propia; una proporción alta de Unknown entre los seguidores nuevos suele indicar cuentas recientes o inactivas.
• Regiones. X permite a los dueños mostrar una región amplia en lugar de su país. Conserva esas filas tal como llegan en lugar de adivinar un país.
• VPN y viajes. La etiqueta sigue el lugar desde donde se conecta una cuenta, así que una VPN o un viaje largo pueden moverla. X añade una advertencia en el panel cuando sospecha una VPN. Entre 1,000 seguidores eso es ruido; para una sola cuenta, lee la etiqueta como una pista, no como una prueba.
• Cambio con el tiempo. La etiqueta se mueve cuando se mueven las personas, y los seguidores van y vienen. Pon fecha a cada mapa y repítelo con el mismo tamaño de muestra para comparar meses.
• Proporciones, no personas. Reporta los países como porcentajes de una audiencia. Una tabla de países entre mil seguidores es investigación de mercado; una lista de personas con nombre por país no es para lo que sirve este método.

Leída así, la tabla responde preguntas prácticas. Antes de pagarle a un creador por una campaña dirigida a un mercado, comprueba qué proporción de sus seguidores tiene realmente su sede allí. Ejecuta el mismo mapa con tus rivales para ver qué mercados alcanzan ellos y tú no, como parte de un análisis de competidores en Twitter. Úsala para elegir la hora de publicar: una audiencia dividida entre Estados Unidos y Europa queda separada por entre seis y nueve horas, así que una sola hora de publicación se pierde una parte. Y repite el mapa en tu propia cuenta cada trimestre para ver de dónde viene el crecimiento.

#Mapea tu primera audiencia por país

Para saber dónde están los seguidores de cualquier cuenta de X, lístalos con GET /followers, toma una muestra de 1,000 y lee el país de cada uno con GET /about. En Sorsa API eso mapea una audiencia de 1M de seguidores desde $8.40, con la proporción de cada país dentro de unos 3 puntos. Empieza con las 100 solicitudes gratis: ejecuta el script con sample_size=90 en una cuenta que conozcas y tenga menos de 2,000 seguidores, y comprueba que la tabla se vea bien.

#Preguntas frecuentes