Recherche

Rechercher une tendance

GET /v1/search/trends reads 2 crédits

Les publications classées que X affiche à l'ouverture d'une tendance : l'ensemble de résultats top pour le nom de la tendance, dans l'ordre où un lecteur le voit sur la page de la tendance.

Paramètres de requête

Paramètre de requête	Type	Signification
`q` *	string	Le nom ou la requête de la tendance, exactement tel qu'il figure dans une réponse de tendances
`count`	int 1–100 = 20	Taille de page demandée ; X la traite comme une indication
`cursor`	string	Le `next_cursor` de la page précédente

réponse

Même forme que la recherche, avec product toujours à top ; next_cursor vaut null sur la première page qui ne porte aucune publication. Champ par champ : Tweet (lecture).

Statut: 200, 400, 422, 429, 502

requête

curl https://api.xsignalfeed.com/v1/search/trends?q=NASA&count=10 \
  -H "Authorization: Bearer xsf_your_key"

réponse · 200 / 400

{
  "query": "NASA",
  "product": "top",
  "tweets": [
    {
      "id": 2100295141441347962,
      "created_ms": 1789584357973,
      "user_id": 15165493,
      "user": "NASASolarSystem",
      "name": "NASA Solar System",
      "text": "…",
      "lang": "en",
      "reply_to": null,
      "reply_to_status_id": null,
      "reply_to_user_id": null,
      "conversation_id": "2100295141441347962",
      "is_rt": false,
      "rt_of": null,
      "is_quote": false,
      "quoted": null,
      "media": [
        "https://pbs.twimg.com/media/HSW_TFmX0AA6HWR.jpg"
      ],
      "media_items": [
        {
          "type": "photo",
          "url": "https://pbs.twimg.com/media/HSW_TFmX0AA6HWR.jpg",
          "expanded_url": "https://x.com/NASASolarSystem/status/2100295141441347962/photo/1",
          "width": 2856,
          "height": 1604
        }
      ],
      "urls": [
        "https://go.nasa.gov/…"
      ],
      "views": "295748",
      "counts": {
        "reply": 103,
        "rt": 444,
        "like": 2990,
        "quote": 58,
        "bookmark": 253
      },
      "source": "<a href=\"https://www.sprinklr.com\" rel=\"nofollow\">Sprinklr</a>"
    },
    {
      "…": "…"
    }
  ],
  "next_cursor": "DAACCgACHSYw9bMAJxAKAAMd…"
}