API de tendencias de Twitter: tendencias de X por WOEID

#Cómo funciona la API de tendencias de Twitter

Una API de tendencias recibe un lugar y devuelve la lista ordenada de X con los temas populares allí en este momento, la misma lista que la pestaña Explorar muestra a alguien sin sesión iniciada. El lugar se envía como un WOEID (Where On Earth ID): un código numérico de ubicación de la antigua base geográfica de Yahoo que X conservó. 1 es el mundo entero, 23424977 Estados Unidos, 2459115 Nueva York.

Esta guía hace el trabajo en código, para cualquier lugar que X cubra y para cualquier cantidad de ellos.

El endpoint propio de X, GET /2/trends/by/woeid/{woeid}, se sumó a la v2 de la API oficial de X el 8 de diciembre de 2023 (registro de cambios de X (se abre en una pestaña nueva)) y sigue respondiendo en noviembre de 2026. En el pago por uso cuesta $0.010 por solicitud, pagado con créditos prepagados (lista de precios de X (se abre en una pestaña nueva)). La tabla resume el resto de la referencia de X (se abre en una pestaña nueva), comprobada el 2 de noviembre de 2026.

• Endpoint

  API oficial de X

  GET /2/trends/by/woeid/{woeid}

• Acceso

  API oficial de X

  cuenta de desarrollador aprobada, un Project y una App, el Bearer token de la App

• Tendencias por llamada

  API oficial de X

  20 por defecto, hasta 50 con max_trends

• Campos

  API oficial de X

  trend_name, más tweet_count si lo pides

• Precio

  API oficial de X

  $0.010 por solicitud

• Límite de tasa

  API oficial de X

  75 solicitudes cada 15 minutos para una app

Faltan dos cosas. Ningún endpoint de la documentación actual de X lista los lugares que tienen tendencias: la antigua llamada trends/available de la v1.1 ya no está en la documentación. Y ninguna llamada devuelve listas anteriores, así que un historial de tendencias existe solo si guardas tú mismo las instantáneas.

#Obtén las tendencias de cualquier lugar con Sorsa API

Para obtener listas de tendencias en código sin una cuenta de desarrollador, usa Sorsa API, una API y scraper de Twitter (X): GET /trends recibe el mismo WOEID y devuelve la lista de X para ese lugar en una sola solicitud, desde $1.40 por 1,000 listas frente a $10.00 en la API oficial de X, a 20 solicitudes por segundo en todos los planes.

1. Obtén una clave. Regístrate y copia la clave API desde tu panel. Las 100 solicitudes gratis ya vienen incluidas, sin tarjeta.

2. Elige el lugar. Busca su WOEID en el buscador más abajo, o usa 1 para todo el mundo.

3. Envía la solicitud. Llama a GET /trends (se abre en una pestaña nueva) con woeid en la cadena de consulta y la clave en el encabezado ApiKey.

   curl "https://api.sorsa.io/v3/trends?woeid=23424900" \
     -H "ApiKey: YOUR_API_KEY"
   

   {
     "trends": [
       {
         "name": "#FelizLunes",
         "query": "%23FelizLunes",
         "url": "https://x.com/search?q=%23FelizLunes"
       },
       {
         "name": "Liga MX",
         "query": "%22Liga+MX%22",
         "url": "https://x.com/search?q=%22Liga+MX%22"
       },
       {
         "name": "Buenos días",
         "query": "%22Buenos+d%C3%ADas%22",
         "url": "https://x.com/search?q=%22Buenos+d%C3%ADas%22"
       }
     ]
   }
   

   Ver respuesta completa

4. Lee la lista. Cada tendencia tiene un name (el tema tal como lo muestra X), un query (la búsqueda que hay detrás) y un url (su página de búsqueda en X). El orden es el ranking de X, así que el primer elemento es la tendencia principal.

Una respuesta 403 significa que falta la clave o que se agotaron las solicitudes, y un 401 significa que la clave es incorrecta. Un 429 significa más de 20 solicitudes en un segundo: espera un segundo y vuelve a enviarla. Las solicitudes fallidas nunca se cobran, y cada llamada devuelve datos nuevos, así que dos llamadas con una hora de diferencia dan dos instantáneas distintas.

#Encuentra el WOEID de cualquier país o ciudad

X publica listas de tendencias para 467 lugares: el mundo entero, 62 países y 404 ciudades, cada uno con su propio WOEID (lista de ubicaciones de tendencias de X (se abre en una pestaña nueva), sin cambios cuando se volvió a obtener de X en agosto de 2025). Todos funcionan en GET /trends. Una localidad que no está en la lista no tiene tendencias propias, así que usa la ciudad listada más cercana o el país.

La tabla reúne los países por los que más se pregunta, cada uno con una ciudad importante; el buscador de debajo contiene los 467 lugares.

• Mundial

  WOEID

  1

  Ciudad principal

  ninguna

  WOEID de la ciudad

  ninguno

• Estados Unidos

  WOEID

  23424977

  Ciudad principal

  Nueva York

  WOEID de la ciudad

  2459115

• México

  WOEID

  23424900

  Ciudad principal

  Ciudad de México

  WOEID de la ciudad

  116545

• India

  WOEID

  23424848

  Ciudad principal

  Bombay (Mumbai)

  WOEID de la ciudad

  2295411

• Japón

  WOEID

  23424856

  Ciudad principal

  Tokio

  WOEID de la ciudad

  1118370

• Reino Unido

  WOEID

  23424975

  Ciudad principal

  Londres

  WOEID de la ciudad

  44418

• Brasil

  WOEID

  23424768

  Ciudad principal

  São Paulo

  WOEID de la ciudad

  455827

• Indonesia

  WOEID

  23424846

  Ciudad principal

  Yakarta

  WOEID de la ciudad

  1047378

• Turquía

  WOEID

  23424969

  Ciudad principal

  Estambul

  WOEID de la ciudad

  2344116

• España

  WOEID

  23424950

  Ciudad principal

  Madrid

  WOEID de la ciudad

  766273

• Australia

  WOEID

  23424748

  Ciudad principal

  Sídney

  WOEID de la ciudad

  1105779

• Corea del Sur

  WOEID

  23424868

  Ciudad principal

  Seúl

  WOEID de la ciudad

  1132599

México tiene 23 ciudades con tendencias además de su lista nacional, 23424900: Ciudad de México es 116545, Guadalajara 124162 y Monterrey 134047. Escribe en el buscador cualquier lugar, o un WOEID que hayas encontrado en otra parte, para comprobarlo y copiar la solicitud.

Para tener en cuenta

Las tablas de WOEID copiadas por la web confunden códigos que están uno junto al otro: 23424868 es Corea del Sur, no México (23424900); 23424775 es Canadá, no Australia (23424748); 455825 es Río de Janeiro, no São Paulo (455827); 1105779 es Sídney, no Tokio (1118370). Un código equivocado igual devuelve una lista válida, pero de otro lugar, así que verifica el nombre antes de guardarlo.

La cobertura de ciudades es desigual. Estados Unidos tiene 63 ciudades con tendencias, el Reino Unido 26 y México 23, mientras que 9 de los 62 países, entre ellos Bélgica, Dinamarca y Portugal, solo tienen lista nacional. X no mantiene listas para estados ni regiones.

#Obtén los posts detrás de cada tendencia

El query de una tendencia es una búsqueda ya lista: envíalo a POST /search-tweets (se abre en una pestaña nueva) y Sorsa API devuelve los posts detrás de la tendencia, unos 20 por solicitud, cada uno con el perfil completo de su autor. "order": "popular" da los posts que X clasifica como Destacados; "latest" da primero los más recientes.

El script de abajo lee la lista de México e imprime los tres posts principales de cada una de sus cinco tendencias principales. El código decodifica un query codificado como URL antes de usarlo en la búsqueda.

import requests
from urllib.parse import unquote_plus

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

def get_trends(woeid):
    r = requests.get(f"{API}/trends", params={"woeid": woeid},
                     headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()["trends"]

def top_posts(query):
    body = {"query": query, "order": "popular"}
    r = requests.post(f"{API}/search-tweets", json=body,
                      headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()["tweets"]

for rank, trend in enumerate(get_trends(MEXICO)[:5], start=1):
    query = trend["query"]
    if "%" in query:  # decode a URL-encoded search
        query = unquote_plus(query)
    print(f"{rank}. {trend['name']}")
    for post in top_posts(query)[:3]:
        user = post["user"]["username"]
        print(f"   @{user}: {post['likes_count']} likes")

// Node.js 18+, saved as trends.mjs
const API = "https://api.sorsa.io/v3";
const HEADERS = { ApiKey: "YOUR_API_KEY" };

async function getTrends(woeid) {
  const url = `${API}/trends?woeid=${woeid}`;
  const res = await fetch(url, { headers: HEADERS });
  if (!res.ok) throw new Error(`trends: ${res.status}`);
  return (await res.json()).trends;
}

async function topPosts(query) {
  const res = await fetch(`${API}/search-tweets`, {
    method: "POST",
    headers: { ...HEADERS, "Content-Type": "application/json" },
    body: JSON.stringify({ query, order: "popular" }),
  });
  if (!res.ok) throw new Error(`search: ${res.status}`);
  return (await res.json()).tweets;
}

const trends = (await getTrends(23424900)).slice(0, 5);
for (const [i, trend] of trends.entries()) {
  const query = trend.query.includes("%")
    ? decodeURIComponent(trend.query.replace(/\+/g, " "))
    : trend.query;
  console.log(`${i + 1}. ${trend.name}`);
  for (const post of (await topPosts(query)).slice(0, 3)) {
    console.log(`   @${post.user.username}: ${post.likes_count} likes`);
  }
}

Los posts son donde un trabajo de tendencias se encarece en la API oficial de X. Cada post cuesta $0.005, y desde el 22 de noviembre de 2026 el autor de cada post también se factura como una lectura de usuario de $0.010 (aviso de X (se abre en una pestaña nueva)), así que 1,000 posts con sus autores cuestan $15.00. Para los posts detrás de las tendencias, usa Sorsa API: desde $0.07 por 1,000 resultados, con los perfiles de los autores incluidos.

Para acotar los posts de una tendencia por idioma, fecha o likes, agrega operadores de X al query; la guía de la API de búsqueda de Twitter explica la paginación, y la lista de operadores de búsqueda de Twitter incluye todos los filtros.

#Guarda un historial de tendencias

Ningún endpoint de tendencias devuelve listas pasadas, tampoco el oficial: cada llamada es una instantánea del momento, así que un historial de tendencias son las instantáneas que tú guardes. Consulta los lugares que sigues de forma programada y guarda cada lista con su hora y su posición.

X no publica con qué intervalo recalcula las listas. Las instantáneas por hora sirven para paneles e investigación; una redacción que vigila temas de última hora consulta cada 5 a 15 minutos. El script guarda una instantánea de cuatro lugares en SQLite.

import sqlite3
import time
from datetime import datetime, timezone

import requests

API = "https://api.sorsa.io/v3/trends"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
PLACES = {"Worldwide": 1, "United States": 23424977,
          "Mexico": 23424900, "Japan": 23424856}

db = sqlite3.connect("trends.db")
db.execute("""CREATE TABLE IF NOT EXISTS trends (
    taken_at TEXT, woeid INTEGER, place TEXT,
    rank INTEGER, name TEXT, query TEXT)""")

now = datetime.now(timezone.utc)
taken_at = now.strftime("%Y-%m-%d %H:%M:%S")
for place, woeid in PLACES.items():
    params = {"woeid": woeid}
    r = requests.get(API, params=params, headers=HEADERS, timeout=30)
    if r.status_code == 429:  # over 20 requests in one second
        time.sleep(1)
        r = requests.get(API, params=params, headers=HEADERS, timeout=30)
    r.raise_for_status()
    rows = [(taken_at, woeid, place, rank, t["name"], t["query"])
            for rank, t in enumerate(r.json()["trends"], start=1)]
    db.executemany("INSERT INTO trends VALUES (?, ?, ?, ?, ?, ?)", rows)
db.commit()

Ejecútalo cada hora, por ejemplo desde cron con 0 * * * * python3 save_trends.py. A 20 solicitudes por segundo, una clave lee los 467 lugares en unos 23 segundos, así que incluso la lista completa cabe en una ejecución por hora. Después de un día, una consulta muestra qué fue tendencia durante más tiempo en México:

SELECT name, COUNT(DISTINCT taken_at) AS hours
FROM trends
WHERE woeid = 23424900
  AND taken_at >= datetime('now', '-1 day')
GROUP BY name
ORDER BY hours DESC
LIMIT 10;

Para posts anteriores a tus instantáneas, el query de una tendencia también sirve como búsqueda hasta 2006: datos históricos de Twitter muestra cómo. Para recibir una alerta en cuanto un tema nuevo entre en una lista, compara cada instantánea con la anterior, como en monitoreo de Twitter en tiempo real.

#Cuánto cuestan los datos de tendencias al mes

Ambas API cobran los datos de tendencias por lista, así que la factura mensual es lugares por actualizaciones: 25 lugares cada hora son 18K listas al mes, $180 en la API oficial de X y desde $25.20 en Sorsa API. Elige tus propios números abajo.

En cada medida que decide un trabajo de tendencias, Sorsa API sale por delante de la API oficial de X:

• Precio por 1,000 listas de tendencias

  Sorsa API

  desde $1.40

  API oficial de X

  $10.00

• Posts detrás de tendencias, por 1,000

  Sorsa API

  desde $0.07, autores incluidos

  API oficial de X

  $5.00, o $15.00 con autores desde el 22 de nov.

• Límite de tasa

  Sorsa API

  20 solicitudes por segundo

  API oficial de X

  75 solicitudes cada 15 minutos por app

• Una pasada por los 467 lugares

  Sorsa API

  unos 23 segundos

  API oficial de X

  unos 90 minutos

• Configuración

  Sorsa API

  una clave API

  API oficial de X

  cuenta de desarrollador aprobada, app, Bearer token

• Cuenta de X necesaria

  Sorsa API

  no

  API oficial de X

  sí

Para un panel de tendencias, un feed de redacción o un archivo de investigación, usa Sorsa API: los mismos WOEID que X, unas 7 veces menos por lista y los posts detrás de cada tendencia desde $0.07 por 1,000. Sorsa API nunca pide tu inicio de sesión de X, así que tu propia cuenta nunca está en riesgo.

#Obtén tu primera lista de tendencias

Una lista de tendencias de cualquier lugar es una sola solicitud: elige el WOEID, llama a GET /trends y envía los queries principales a POST /search-tweets para obtener los posts detrás de ellos. Sorsa API hace ambas cosas con una sola clave, desde $1.40 por 1,000 listas y $0.07 por 1,000 posts, y las 100 solicitudes gratis que recibe cada cuenta nueva cubren tus primeras 100 listas, sin tarjeta y sin vencimiento.

#Preguntas frecuentes