Tendencias

Obtener tendencias

GET /v1/trends reads 2 créditos

Los temas en tendencia de la página Explorar de X como lista ordenada: la lista general de Tendencias, o la pestaña Noticias, Deportes o Entretenimiento.

Parámetros de consulta

Parámetro de consulta	Tipo	Significado
`category`	trending \| news \| sport \| entertainment = trending	`trending`, `news`, `sport` o `entertainment` (sin distinguir mayúsculas; se acepta `sports`). La pestaña Deportes está vacía con frecuencia.
`limit`	int 1–100 = 30	Número máximo de tendencias a devolver

respuesta

La categoría, el título que X muestra sobre la lista (null cuando no hay ninguno) y las tendencias en orden de posición — cada una con su nombre, la etiqueta de contexto que X le adjunta, el recuento de publicaciones o la línea de resumen cuando X los muestra, las tendencias agrupadas relacionadas y una URL de búsqueda. La lista es una sola página; puede estar vacía para una pestaña en la que X no muestra nada en ese momento, y una lista vacía no se cobra.

Estado: 200, 400, 422, 429, 502

solicitud

curl https://api.xsignalfeed.com/v1/trends?category=trending&limit=20 \
  -H "Authorization: Bearer xsf_your_key"

respuesta · 200 / 400

{
  "category": "trending",
  "title": "United States trends",
  "trends": [
    {
      "rank": 1,
      "name": "#dwts",
      "description": null,
      "posts": null,
      "domain": "Movies & TV · Trending",
      "url": "https://x.com/search?q=%23dwts&src=trend_click&vertical=trends",
      "related": [
        "Maura",
        "Amber"
      ]
    },
    {
      "rank": 2,
      "name": "#AEWDynamite",
      "description": null,
      "posts": null,
      "domain": "Wrestling · Trending",
      "url": "https://x.com/search?q=%23AEWDynamite&src=trend_click&vertical=trends",
      "related": [
        "All Out",
        "Lena Kross"
      ]
    }
  ]
}