Trends

Trends ophalen

GET /v1/trends reads 2 credits

De trending onderwerpen op de Ontdekken-pagina van X als gerangschikte lijst: de algemene Trending-lijst, of het tabblad Nieuws, Sport of Entertainment.

Queryparameters

QueryparameterTypeBetekenis
categorytrending | news | sport | entertainment = trendingtrending, news, sport of entertainment (niet hoofdlettergevoelig; sports wordt geaccepteerd). Het tabblad Sport is vaak leeg.
limitint 1–100 = 30Maximumaantal trends om terug te geven

antwoord

De categorie, de titel die X boven de lijst toont (null als die er niet is) en de trends in rangvolgorde — elk met zijn naam, het contextlabel dat X eraan koppelt, het berichtaantal of de samenvattingsregel wanneer X die toont, gerelateerde gegroepeerde trends en een zoek-URL. De lijst is één enkele pagina; hij kan leeg zijn voor een tabblad waarin X op dit moment niets toont, en een lege lijst wordt niet in rekening gebracht.

Status: 200, 400, 422, 429, 502

verzoek
curl https://api.xsignalfeed.com/v1/trends?category=trending&limit=20 \
  -H "Authorization: Bearer xsf_your_key"
antwoord · 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"
      ]
    }
  ]
}