API de X / Twitter: Tendencias
Obtén las tendencias actuales de X (Twitter) a nivel mundial, de un país o de una ciudad, en el orden del ranking de X, incluida la ubicación resuelta.
US$0.10/1k solic., pagas por solicitud, sin suscripción.
Trending
United States
Trending in United States
#NBAOpeningNight
Trending in United States
Federal Reserve
Promoted
iPhone 18
Trending in United States
#MondayMotivation
Trending in United States
Coachella 2027
{"rank": 1,"name": "#NBAOpeningNight","isHashtag": true,"query": "%23NBAOpeningNight","promoted": false,"url": "https://x.com/search?q=%23NBAOpeningNight"}
Precios y proveedores
Precios del endpoint Tendencias de la API de X / Twitter: una API, 2 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
Pruébalo
Obtén Tendencias de X / Twitter en una sola solicitud
Este ejemplo muestra 12 de 13 campos. Ver todos los campos
{
"found": true,
"data": {
"location": "United States",
"locationId": "23424977",
"asOfUtc": 1727366400,
"items": [
{
"rank": 1,
"name": "#NBAOpeningNight",
"isHashtag": true,
"query": "%23NBAOpeningNight",
"promoted": false,
"url": "https://x.com/search?q=%23NBAOpeningNight"
},
{
"rank": 2,
"name": "Federal Reserve",
"isHashtag": false,
"query": "%22Federal%20Reserve%22",
"promoted": false,
"url": "https://x.com/search?q=%22Federal%20Reserve%22"
},
{
"rank": 3,
"name": "iPhone 18",
"isHashtag": false,
"query": "%22iPhone%2018%22",
"promoted": true,
"url": "https://x.com/search?q=%22iPhone%2018%22"
},
{
"rank": 4,
"name": "#MondayMotivation",
"isHashtag": true,
"query": "%23MondayMotivation",
"promoted": false,
"url": "https://x.com/search?q=%23MondayMotivation"
},
{
"rank": 5,
"name": "Coachella 2027",
"isHashtag": false,
"query": "%22Coachella%202027%22",
"promoted": false,
"url": "https://x.com/search?q=%22Coachella%202027%22"
}
]
}
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- limitinteger
10
Número máximo de tendencias del ranking a devolver (1-50, por defecto 50).
- locationstring
United States
Nombre de país, nombre de ciudad o código ISO de país. Omítelo para tendencias mundiales.
- requireFieldsarray
Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `promoted`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en una tendencia que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.
Respuesta
JSON, un valor de ejemplo por campo.
The resolved location and its current ranked trends, or null when unavailable.
- asOfUtcnumber
1727366400
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- locationstring
United States
Resolved X trend-location name. Populated whenever the provider has data for the entity.
- locationIdstring
23424977
Resolved Yahoo WOEID used by X, exposed as a stable location identifier. Populated whenever the provider has data for the entity.
Current trends in X's own ranking order. Distinct ranks may carry the same trend name. Populated whenever the provider has data for the entity.
- isHashtagbooleanse puede exigir
true
Whether the trend text is a hashtag.
- namestring
#NBAOpeningNight
Trend text displayed by X. Populated whenever the provider has data for the entity.
- promotedbooleanse puede exigir
false
Whether X marks the trend as promoted.
- querystring
%23NBAOpeningNight
Search query corresponding to the trend. Populated whenever the provider has data for the entity.
- rankinteger
1
One-based position in X's trend ranking. Populated whenever the provider has data for the entity.
- urlstring
https://x.com/search?q=%23NBAOpeningNight
X search URL for the trend.
- foundboolean
true
Whether X trends were resolved for the requested location.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preguntas frecuentes
Acerca del endpoint Tendencias de la API de X / Twitter
El endpoint Tendencias de AnyAPI para X / Twitter devuelve datos de X / Twitter como JSON normalizado con una sola llamada POST a /v1/run/twitter.trends. Obtén las tendencias actuales de X (Twitter) a nivel mundial, de un país o de una ciudad, en el orden del ranking de X, incluida la ubicación resuelta. AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.10 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 99.8% de las llamadas al endpoint Tendencias de la API de X / Twitter a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 1.2 segundos en 3535 llamadas medidas.