API de tendencias de Twitter: obtener temas en tendencia en 2026

Por Sorsa Editorial

Actualizado el 8 de julio de 2026: agregada la asignación inicial de 100 solicitudes gratis, refrescado el precio por solicitud vigente contra la tarifa de tendencias de pago por uso oficial y reconfirmado el conteo de resultados por defecto del endpoint y el campo de conteo de tweets a menudo vacío.

Conclusión clave: Para obtener los temas en tendencia de Twitter (X) a través de una API en 2026, envía una solicitud GET autenticada con un WOEID, el Where On Earth IDentifier numérico de una ubicación. La API oficial de X lo sirve en GET /2/trends/by/woeid/{woeid} en los niveles de pago usando un token Bearer, cubriendo aproximadamente 470 ubicaciones de tendencias en el mundo.

Una API de tendencias de Twitter no tiene por qué significar OAuth, una cola de revisión de app, o un contrato de cinco cifras. Sorsa API, una API alternativa de Twitter/X, devuelve las mismas tendencias basadas en WOEID a través de una sola llamada /trends autenticada con una clave API. Cada tendencia regresa ya emparejada con una consulta de búsqueda lista para correr y una URL directa, y el cobro es de tarifa plana por solicitud: una extracción de tendencias cuesta alrededor de $0.002 en el plan Pro ($199 por 100,000 solicitudes) contra aproximadamente $0.20 en la API oficial, que lee las mismas 20 tendencias a $0.010 cada una. El límite de tasa es de 20 solicitudes por segundo en todos los planes, sin ventanas de 15 minutos.

Los temas en tendencia son una de las pocas señales en tiempo real en la web abierta que muestran a qué le están prestando atención millones de personas en este momento. Los equipos de marketing los usan para cronometrar campañas, las salas de redacción los usan para detectar noticias de última hora, y los escritorios cuantitativos los tratan como una capa de señal temprana. La parte difícil en 2026 rara vez es el caso de uso. Es sacar los datos de forma limpia, porque el camino oficial es más fragmentado y más caro de lo que la mayoría de los tutoriales admiten.

Esta guía cubre lo que realmente está disponible hoy: cómo funciona la recuperación basada en WOEID, cómo se comporta el endpoint de tendencias de la API oficial de X v2 (incluido dónde se queda corto), cómo extraer tendencias con una sola clave API, y código funcional en Python, Node.js y curl. La mayoría de los tutoriales existentes todavía referencian el endpoint v1.1 descontinuado y el flujo OAuth 1.0a de Tweepy, que ya no aplica a las tendencias.

Tabla de contenidos

1. ¿Qué es la API de tendencias de Twitter?
2. Dos formas de obtener las tendencias de X por código en 2026
3. Cómo funciona WOEID (y por qué cada llamada de tendencias necesita uno)
4. Obtener temas en tendencia con la Sorsa API
5. Referencia de WOEID: principales países y ciudades
6. Ejemplos de código: Python, Node.js y curl
7. Combinar tendencias con búsqueda para un análisis más profundo
8. Problemas comunes con el endpoint de tendencias oficial de X
9. Casos de uso para los datos de tendencias
10. Límites de tasa, caché y mejores prácticas
11. En la práctica: sondeo de tendencias para un escritorio de redacción
12. Preguntas frecuentes
13. Cómo empezar

¿Qué es la API de tendencias de Twitter? {#what-is-the-twitter-trends-api}

Una API de tendencias de Twitter es un endpoint HTTP que devuelve los temas que actualmente están en tendencia en X (antes Twitter) para un área geográfica específica. Una respuesta típica es una lista clasificada de alrededor de 20 a 50 temas para una ubicación, recalculada por la plataforma cada pocos minutos. Las tendencias accedidas de esta forma están acotadas por ubicación, no personalizadas.

La distinción importa. La vista personalizada de «Tendencias para ti» en el sitio web de X mezcla las cuentas que sigues y tu actividad, y no está expuesta a través de ninguna API. Lo que una API devuelve es la lista a nivel de plataforma y acotada por ubicación que X calcula para una región, que es exactamente lo que quieres para analítica, monitoreo e investigación.

La lista se recalcula cada pocos minutos. Para casi toda carga de trabajo, sondear cada ubicación una vez cada 5 a 15 minutos atrapa las nuevas entradas conforme aparecen sin desperdiciar solicitudes.

Dos formas de obtener las tendencias de X por código en 2026 {#two-ways-to-get-x-trends-through-code-in-2026}

Existen dos caminos prácticos para recuperar los temas en tendencia de X por código en 2026: el endpoint de tendencias de la API oficial de X v2, autenticado con un token Bearer de OAuth 2.0 en un nivel de pago, y las APIs REST de terceros que envuelven los mismos datos basados en WOEID detrás de una sola clave API. Ambas devuelven tendencias acotadas por ubicación; difieren en autenticación, precio y en lo que cada objeto de tendencia incluye.

Opción 1: El endpoint de tendencias de la API oficial de X v2

X expone su endpoint de tendencias en GET /2/trends/by/woeid/{woeid}. Toma un WOEID como parámetro de ruta y devuelve una lista de objetos de tendencia, cada uno cargando un trend_name y un tweet_count opcional que solicitas a través del parámetro trend.fields. La referencia completa vive en la documentación oficial de tendencias de X.

La autenticación es un token Bearer de OAuth 2.0, lo que significa registrar una app de desarrollador y sentarse en un nivel de pago de la API de X. No hay acceso gratuito a las tendencias en 2026, y la plataforma ahora cobra las lecturas por recurso, así que cada tendencia devuelta es una unidad medida por separado. Para el contexto más amplio sobre cómo funciona ese precio, revisa nuestro desglose de precios de la API de X en 2026 y por qué la API oficial es tan cara.

Para ir de un tema en tendencia a las publicaciones reales detrás de él, construyes tu propia consulta de búsqueda y llamas al endpoint de búsqueda por separado.

Opción 2: Un endpoint de tendencias de una sola clave

El endpoint de tendencias de Sorsa está construido en torno a una prioridad diferente: hacer los datos de tendencias usables en el siguiente paso mismo de un pipeline. La respuesta incluye el nombre de la tendencia más una consulta de búsqueda prearmada y una URL directa, así que puedes fluir directo a un análisis más profundo sin escribir ningún código de construcción de consultas.

La autenticación es una sola clave API en el encabezado ApiKey. No hay flujo OAuth, ni registro de app, ni revisión de desarrollador. Regístrate, copia una clave, envía la solicitud, y las primeras 100 solicitudes son gratis sin tarjeta requerida. El precio es de tarifa plana por solicitud a lo largo de cada endpoint, incluidas las tendencias, así que una extracción de lista de tendencias cuesta lo mismo que una consulta de usuario o una llamada de búsqueda.

Lado a lado: tendencias de la API oficial de X vs Sorsa

Una comparación factual para la recuperación de tendencias en específico, con los límites genuinos de cada opción declarados con claridad.

El patrón que se sigue de los números: a cualquier volumen real de sondeo, el cobro de tarifa plana por solicitud es mucho más barato que pagar por cada tendencia individual, y una sola clave API quita la sobrecarga de OAuth y de revisión de app. Las salvedades honestas son que ninguna opción devuelve tendencias históricas, y que el endpoint de Sorsa no adjunta una cifra de volumen de tweets a cada tendencia. Las siguientes secciones muestran cómo trabajar con ambas, y la sección de Problemas comunes cubre por qué el tweet_count oficial es poco confiable en primer lugar.

Cómo funciona WOEID (y por qué cada llamada de tendencias necesita uno) {#how-woeid-works-and-why-every-trends-call-needs-one}

Un WOEID (Where On Earth IDentifier) es un ID numérico que etiqueta de forma única un lugar geográfico. Twitter adoptó los WOEIDs para las tendencias alrededor de 2010 y todavía los usa, así que cada llamada a la API de tendencias requiere un WOEID para la ubicación que quieres. Hay aproximadamente 470 WOEIDs de tendencias válidos, que abarcan los niveles mundial, de país y de ciudad.

Unos cuantos ejemplos hacen clara la forma:

• 1 es Mundial (tendencias globales)
• 23424977 es Estados Unidos
• 23424975 es el Reino Unido
• 23424900 es México
• 2459115 es la Ciudad de Nueva York
• 44418 es Londres

Los IDs a nivel de país cubren un país entero, mientras que los IDs a nivel de ciudad cubren una sola área metropolitana. No todos los países tienen tendencias a nivel de ciudad; los mercados más pequeños a menudo devuelven solo una única lista de todo el país. No te autenticas diferente por región y no hay precio por región. Si conoces el entero, puedes obtener sus tendencias.

Cómo encontrar el WOEID para una ubicación

Para los mercados más comunes, usa la tabla de referencia de abajo. Para cualquier cosa más allá de los mercados principales, una lista completa de las ubicaciones de tendencias compatibles con X se mantiene como un gist público de WOEID en GitHub con todas las entradas válidas. La Sorsa API no expone un endpoint separado de «ubicaciones disponibles», así que el gist es la consulta canónica; si una ubicación no está en él, X no publica datos de tendencias para ese lugar a nivel de API.

Obtener temas en tendencia con la Sorsa API {#getting-trending-topics-with-the-sorsa-api}

El endpoint de tendencias toma un solo parámetro de consulta, woeid, y devuelve una lista de objetos de tendencia. No hay modo histórico ni paginación: cada llamada devuelve la lista actual en el momento de la solicitud.

Solicitud:

GET https://api.sorsa.io/v3/trends?woeid=23424977
Header: ApiKey: YOUR_API_KEY

Respuesta:

{
  "trends": [
    {
      "name": "#FedDecision",
      "query": "%23FedDecision",
      "url": "https://twitter.com/search?q=%23FedDecision"
    },
    {
      "name": "Powell",
      "query": "Powell",
      "url": "https://twitter.com/search?q=Powell"
    },
    {
      "name": "rate cut",
      "query": "%22rate+cut%22",
      "url": "https://twitter.com/search?q=%22rate+cut%22"
    }
  ]
}

Cada objeto de tendencia tiene tres campos:

• name: la etiqueta legible por humanos del tema en tendencia. Muéstrala en tu UI.
• query: la cadena de búsqueda codificada en URL. Pásala al endpoint de búsqueda para recuperar las publicaciones reales detrás de la tendencia.
• url: un enlace directo a la página de resultados de búsqueda de X, útil para referencias clicables en dashboards o alertas.

Para construir un registro histórico, sondea con tu propia programación y guarda cada instantánea. Una corrida cada 10 a 15 minutos por ubicación, escrita a un almacén de serie de tiempo, se vuelve un dataset usable en unas pocas semanas. La forma completa de solicitud y respuesta está documentada en la referencia del endpoint de tendencias, y la guía de quickstart recorre cómo conseguir una clave.

Referencia de WOEID: principales países y ciudades {#woeid-reference-top-countries-and-cities}

Las tablas de abajo cubren los WOEIDs que salen con más frecuencia en producción. Para cada ubicación compatible, usa el gist público de WOEID.

Global

Países

Ciudades principales

Para ciudades más pequeñas y mercados regionales, usa el gist completo de WOEID.

Ejemplos de código: Python, Node.js y curl {#code-examples-python-nodejs-and-curl}

Los tres ejemplos de abajo golpean el mismo endpoint y solo requieren una clave API en el encabezado ApiKey.

curl

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

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
headers = {"ApiKey": API_KEY}

# US trends (WOEID 23424977)
resp = requests.get(f"{BASE}/trends", headers=headers, params={"woeid": 23424977})
trends = resp.json()["trends"]

for t in trends[:10]:
    print(t["name"], "->", t["url"])

Node.js

const API_KEY = "YOUR_API_KEY";

async function getTrends(woeid) {
  const res = await fetch(`https://api.sorsa.io/v3/trends?woeid=${woeid}`, {
    headers: { ApiKey: API_KEY },
  });
  const { trends } = await res.json();
  return trends;
}

// US trends
getTrends(23424977).then((trends) => {
  trends.slice(0, 10).forEach((t) => console.log(t.name, t.url));
});

Sondear varias regiones en paralelo

Cuando rastreas varios mercados a la vez, dispara las solicitudes de forma concurrente en lugar de en un bucle. El límite de 20 solicitudes por segundo hace triviales un puñado de regiones.

import asyncio
import aiohttp

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
WOEIDS = {"US": 23424977, "UK": 23424975, "Japan": 23424856, "Brazil": 23424768}

async def fetch_trends(session, name, woeid):
    url = f"{BASE}/trends"
    async with session.get(url, headers={"ApiKey": API_KEY}, params={"woeid": woeid}) as r:
        data = await r.json()
        return name, [t["name"] for t in data["trends"][:10]]

async def main():
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_trends(session, n, w) for n, w in WOEIDS.items()]
        for name, tops in await asyncio.gather(*tasks):
            print(name, tops)

asyncio.run(main())

Combinar tendencias con búsqueda para un análisis más profundo {#combining-trends-with-search-for-deeper-analysis}

Un nombre de tendencia por sí solo te dice que una frase está caliente. El valor viene de extraer las publicaciones detrás de ella, y el campo query prearmado convierte eso en una llamada extra en lugar de un ejercicio de construcción de consultas. Cuando sí necesitas elaborar filtros a mano, el constructor de consultas de búsqueda ensambla la sintaxis por ti. El query llega codificado en URL, así que decodifícalo antes de pasarlo al endpoint de búsqueda, que espera texto plano.

import requests
from urllib.parse import unquote_plus

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
headers = {"ApiKey": API_KEY}

# 1. Get current US trends
trends = requests.get(
    f"{BASE}/trends", headers=headers, params={"woeid": 23424977}
).json()["trends"]

# 2. For the top few trends, pull the posts driving each one
for trend in trends[:5]:
    body = {"query": unquote_plus(trend["query"]), "order": "popular"}
    posts = requests.post(f"{BASE}/search-tweets", headers=headers, json=body).json()["tweets"]
    print(trend["name"], "->", len(posts), "top posts")

De aquí puedes ordenar cuentas por engagement en esas publicaciones, clasificar el sentimiento o enrutar cualquier cosa que coincida con una lista de vigilancia a Slack. El paso de búsqueda está cubierto de principio a fin en nuestra guía de la API de búsqueda de Twitter, y una versión siempre activa corre en el recorrido de monitoreo en tiempo real. Como tanto la extracción de tendencias como cada búsqueda son solicitudes individuales de tarifa plana, un pipeline de tendencias-a-publicaciones se mantiene barato incluso a alta frecuencia.

Problemas comunes con el endpoint de tendencias oficial de X {#common-issues-with-the-official-x-trends-endpoint}

El endpoint de tendencias oficial de X comúnmente devuelve menos tendencias de lo esperado, alrededor de 20 por ubicación por defecto en lugar de las 50 que devolvía el endpoint más viejo v1.1, y ocasionalmente devuelve una lista vacía durante problemas del lado de la plataforma. Su campo tweet_count es frecuentemente null incluso cuando se solicita a través de trend.fields, y el acceso está restringido a los niveles de pago de la API.

Estos no son casos límite. Aparecen repetidamente en los propios foros de desarrolladores de X:

• Solo alrededor de 20 tendencias. Los desarrolladores que llaman a GET /2/trends/by/woeid/{woeid} en v2 reportan recibir aproximadamente 20 ítems, mientras que la documentación no promete las 50 que v1.1 solía devolver. Si específicamente necesitas una lista más larga, tienes que trabajar dentro de ese default y del parámetro de conteo de resultados del endpoint.
• Respuestas vacías. Durante incidentes de plataforma, el endpoint ha devuelto listas de tendencias en blanco para cada WOEID a la vez. Esto refleja los datos upstream, no tu código, así que cualquier poller de producción necesita manejar un array vacío con elegancia.
• Volumen de tweets faltante. El campo tweet_count se supone que carga el volumen por tendencia, pero múltiples desarrolladores reportan que devuelve null incluso cuando trend.fields está configurado correctamente. Tratar esa cifra como confiable es un error.
• Sobrecarga de nivel de pago y de OAuth. Las tendencias no son parte de ningún nivel gratuito, y cada llamada necesita un token Bearer atado a una app registrada, que es la parte más lenta de empezar.
• El rastro de v1.1 es un callejón sin salida. Los tutoriales más viejos apuntan a GET trends/place en v1.1, que X ha descontinuado. El código copiado de esas guías no funcionará.

Esta es la razón práctica por la que existe una alternativa de una sola clave. Extraer tendencias a través de una API alternativa de Twitter/X como Sorsa esquiva la configuración de OAuth y el cobro por recurso, devuelve la lista actual completa en una solicitud y empareja cada tendencia con una consulta de búsqueda lista. El hueco de volumen de tweets aplica a ambos caminos, y la respuesta honesta para cualquiera de los dos es la misma: deriva el volumen contando los resultados de búsqueda para una tendencia sobre una ventana de tiempo, que es una medida más veraz que un campo que la plataforma deja vacío.

Casos de uso para los datos de tendencias {#use-cases-for-trend-data}

Los datos de tendencias se ven decorativos hasta que se sientan dentro de un pipeline real. Estos son los patrones que impulsan la mayor parte del uso de producción.

Marketing de contenido en tiempo real. Los equipos sociales extraen tendencias regionales cada 10 a 15 minutos, las puntúan contra las reglas de voz de marca y hacen emerger las que son seguras para interactuar. El momento original de Oreo en el Super Bowl fue una versión manual de esto; la versión automatizada corre sobre un feed de tendencias.

Alertas de sala de redacción. Los escritorios de noticias vigilan un mercado primario más unos cuantos fronterizos y disparan una alerta de Slack cuando un tema desconocido entra al top diez, a menudo atrapando una historia antes de que llegue a los cables.

Investigación de señales de trading. Los equipos cuantitativos extraen tendencias en los mercados objetivo en un intervalo ajustado y las cruzan contra tickers y palabras clave de sector. Un tema en tendencia a veces precede al movimiento de precio correspondiente, lo que lo hace una capa de entrada útil.

Planeación de campañas localizadas. Las agencias extraen tendencias para cada mercado en el que opera un cliente, una o dos veces al día, para decidir qué creativo se envía a dónde. La salida usualmente es una hoja o un dashboard de BI en lugar de un sistema en vivo.

Monitoreo de marca y de crisis. La aparición súbita de una marca o producto en las tendencias regionales a menudo es la señal más temprana de un evento de PR. Emparejar las tendencias con el rastreo de menciones convierte esto en una alarma barata y confiable, y se empareja naturalmente con un flujo de trabajo de escucha social o de rastreo de competidores.

En cada uno de estos, la llamada de tendencias es la parte barata. El trabajo es lo que haces con el resultado, y por eso el cobro de tarifa plana por solicitud importa más aquí de lo que parece al principio.

Límites de tasa, caché y mejores prácticas {#rate-limits-caching-and-best-practices}

Unas cuantas notas prácticas para correr esto a escala.

Cachea agresivamente. Las tendencias cambian cada pocos minutos como máximo, así que cachear los resultados por 5 a 10 minutos por WOEID cubre casi todo caso de uso y recorta el volumen de solicitudes por órdenes de magnitud. Redis con un TTL es la implementación más simple.

Respeta el límite de tasa. Sorsa hace cumplir 20 solicitudes por segundo por clave API a lo largo de todos los endpoints, incluido /trends. Sondear 20 regiones cada 30 segundos está bien; sondear 200 regiones cada segundo no lo está, y devuelve 429 Too Many Requests. Para mayor rendimiento, la página de límites de tasa cubre los límites personalizados.

Maneja las listas vacías. Algunos WOEIDs más pequeños ocasionalmente devuelven arrays cortos o vacíos. Esto es normal y refleja los datos subyacentes de X, así que programa de forma defensiva.

Usa el campo query, no name, para la búsqueda. El name es legible por humanos pero puede contener caracteres que necesitan escape. El query ya está codificado en URL y es lo que X usa internamente; decodifícalo antes de pasarlo al endpoint de búsqueda.

Escalona los sondeos programados. Cuando rastreas 50 WOEIDs, no dispares los 50 en el límite del minuto. Espárcelos a lo largo de una ventana de 30 segundos para evitar la carga en ráfaga. La documentación también cubre los patrones de solicitud para optimizar el uso de la API a escala.

En la práctica: sondeo de tendencias para un escritorio de redacción {#in-practice-trend-polling-for-a-newsroom-desk}

Los equipos que más se apoyan en los datos de tendencias son las salas de redacción sociales y los escritorios de monitoreo de marca. Un grupo de analítica de medios de unas 12 personas con el que trabajamos sondeaba tendencias regionales a lo largo de ocho mercados cada pocos minutos para atrapar noticias de última hora temprano.

En el modelo de pago por uso de la API oficial, leer alrededor de 30 tendencias por mercado a lo largo de ocho mercados cada cinco minutos suma rápido, porque cada tendencia devuelta es un recurso cobrado por separado y un mes ocupado empuja hacia los techos de lectura de la plataforma. Mover el mismo sondeo a un plan de tarifa plana por solicitud colapsó eso en una sola cifra mensual predecible y quitó la contabilidad por recurso por completo, ya que una extracción de ubicación cuenta como una solicitud sin importar cuántas tendencias regresen. El ahorro no fue una optimización ingeniosa; se sigue directamente de que el cobro de tarifa plana es mucho más barato que el cobro por recurso a este volumen, la misma brecha de aproximadamente 100x por extracción mostrada en la tabla de comparación de arriba.

Preguntas frecuentes {#frequently-asked-questions}

¿La API de X v2 tiene un endpoint de tendencias?

Sí. El endpoint de tendencias de la API de X v2 es GET /2/trends/by/woeid/{woeid}. Toma un WOEID como parámetro de ruta, devuelve una lista de objetos de tendencia y admite un campo tweet_count opcional a través del parámetro trend.fields. La autenticación usa un token Bearer de OAuth 2.0, y el acceso está limitado a los niveles de pago de la API de X. El endpoint legado trends/place de v1.1 ha sido descontinuado.

¿Por qué el endpoint de tendencias de X devuelve solo 20 tendencias o una respuesta vacía?

El endpoint de tendencias de la API de X v2 devuelve alrededor de 20 tendencias por ubicación por defecto, menos que las 50 que devolvía el endpoint retirado v1.1, y su documentación no garantiza un conteo fijo. También puede devolver un array vacío durante incidentes del lado de la plataforma, lo que afecta a todos los WOEIDs a la vez en lugar de indicar un bug en tu solicitud. Los pollers de producción deberían manejar las listas cortas y vacías con elegancia.

¿Hay una API de tendencias de Twitter gratuita?

No hay acceso gratuito a las tendencias a través de la API oficial de X en 2026, ya que las tendencias se sientan detrás de niveles de pago y las lecturas se cobran por recurso. Existen scrapers gratuitos y endpoints no oficiales pero tienden a tener límite de tasa y a ser poco confiables. Para un acceso confiable a bajo costo, una API alternativa de Twitter/X como Sorsa te empieza con 100 solicitudes gratis, sin tarjeta requerida, luego cobra una tarifa plana, así que una extracción de tendencias cuesta aproximadamente $0.002 en el plan Pro y las cargas de trabajo pequeñas cuestan unos pocos dólares al mes.

¿Cuál es la diferencia entre la API de tendencias oficial de X y Sorsa?

El endpoint de tendencias oficial de X devuelve nombres de tendencia con un conteo de tweets opcional y a menudo vacío y requiere un token Bearer de OAuth 2.0 en un nivel de pago cobrado por lectura de tendencia. El endpoint /trends de Sorsa devuelve cada nombre de tendencia con una consulta de búsqueda prearmada y una URL directa, se autentica con una sola clave API y cobra una tarifa plana por solicitud. Para los pipelines que combinan tendencias con búsqueda, el campo query listo para usar quita el paso de construir la sintaxis de búsqueda a mano.

¿Las tendencias de Twitter incluyen el volumen o los conteos de tweets?

El endpoint de tendencias oficial de X expone un campo tweet_count, pero los desarrolladores reportan que devuelve null incluso cuando se solicita a través de trend.fields, así que es poco confiable. El endpoint de Sorsa no adjunta una cifra de volumen a cada tendencia. La forma más veraz de medir el volumen en cualquiera de los caminos es consultar el endpoint de búsqueda con la consulta de la tendencia y contar los resultados sobre una ventana de tiempo fija.

¿Puedo obtener tendencias para una ciudad específica?

Sí, cuando X admite tendencias para esa ciudad. Los WOEIDs a nivel de ciudad cubren la mayoría de las metrópolis principales del mundo, de aproximadamente 470 ubicaciones de tendencias compatibles en total. Las ciudades más pequeñas usualmente no tienen una lista dedicada y recurren a los datos a nivel de país. El gist público de WOEID lista cada ubicación compatible, y cualquier ciudad en él se puede pasar directamente como el parámetro woeid.

¿Cómo encuentro el WOEID para un país o una ciudad?

Revisa la tabla de referencia en esta guía para los mercados comunes. Para cualquier otra cosa, el gist público de WOEID en GitHub lista cada ubicación de tendencias compatible con X y su ID numérico. Si un lugar no está en esa lista, X no publica datos de tendencias para él a nivel de API, así que no hay WOEID que consultar.

¿Puedo obtener tendencias históricas de Twitter?

Ninguna API de tendencias devuelve datos históricos; tanto el endpoint oficial de X como el endpoint de Sorsa devuelven solo la lista actual. Para construir historial, sondea con una programación y guarda cada instantánea, típicamente cada 10 a 15 minutos por ubicación escrita a una base de datos de serie de tiempo. Como Sorsa cobra una tarifa plana por solicitud, el sondeo frecuente para un archivo histórico se mantiene económico.

Cómo empezar {#getting-started}

El camino más rápido a tu primera lista de tendencias:

1. Crea una cuenta en el dashboard de Sorsa y copia una clave API, sin aprobación de cuenta de desarrollador que esperar.
2. Envía una solicitud GET a https://api.sorsa.io/v3/trends con tu clave en el encabezado ApiKey y un WOEID como 1 (Mundial) o 23424977 (Estados Unidos).
3. Pasa el campo query prearmado de cada tendencia al endpoint de búsqueda para recuperar las publicaciones reales que impulsan la tendencia.

Cada cuenta nueva incluye 100 solicitudes gratis para empezar, sin tarjeta requerida, y los planes de pago empiezan en $49 al mes por 10,000 solicitudes, con 20 solicitudes por segundo en cada nivel. La API ha servido más de 5 mil millones de solicitudes desde 2022. Puedes probar cualquier endpoint sin escribir código en el Playground de Sorsa, leer la referencia de la API completa o comparar las opciones en nuestra guía de alternativa a la API de Twitter. Para volumen más allá de los planes estándar, el equipo maneja los límites personalizados a través de habla con ventas.

Revisado por Keksich, fundador de Sorsa, marketer e investigador de la API de X.

Esta guía se apoya en nuestro trabajo práctico construyendo y operando Sorsa, una API alternativa de Twitter/X, y en probar el endpoint /trends en vivo contra el oficial durante esta actualización. La ruta del endpoint oficial, el comportamiento de resultados y el cobro se verificaron contra la documentación oficial de tendencias de X y los hilos del foro de desarrolladores de X sobre los límites de resultados y el campo de conteo de tweets; la cobertura de WOEID se revisó contra el gist público de WOEID. El precio para ambos proveedores refleja las cifras vigentes al 9 de junio de 2026. Última verificación el 9 de junio de 2026.