Tendências

Obter tendências

GET /v1/trends reads 2 créditos

Os assuntos em alta da página Explorar do X como uma lista classificada: a lista geral de Tendências, ou a aba Notícias, Esportes ou Entretenimento.

Parâmetros de consulta

Parâmetro de query	Tipo	Significado
`category`	trending \| news \| sport \| entertainment = trending	`trending`, `news`, `sport` ou `entertainment` (sem distinção de maiúsculas; `sports` é aceito). A aba Esportes fica vazia com frequência.
`limit`	int 1–100 = 30	Número máximo de tendências a retornar

resposta

A categoria, o título que o X mostra acima da lista (null quando não há) e as tendências em ordem de classificação — cada uma com seu nome, o rótulo de contexto que o X anexa, a contagem de publicações ou a linha de resumo quando o X a mostra, tendências relacionadas agrupadas e uma URL de busca. A lista é uma página única; pode vir vazia para uma aba em que o X não mostra nada no momento, e uma lista vazia não é cobrada.

Status: 200, 400, 422, 429, 502

requisição

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

resposta · 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"
      ]
    }
  ]
}