Zoeken

Berichten zoeken

GET /v1/search reads 2 credits

Berichten die voldoen aan een zoekquery in een van de zoekproducten van X: latest (nieuwste eerst), top (gerangschikt) of media (berichten met foto's of video). De volledige grammatica van X-zoekoperatoren wordt geaccepteerd in q, bijvoorbeeld from:nasa filter:links -is:retweet.

Queryparameters

Queryparameter	Type	Betekenis
`q` *	string	De zoekquery; X-operatoren zoals `from:`, `to:`, `filter:`, `lang:`, `min_faves:`, zinnen tussen aanhalingstekens en `-word`-uitsluitingen worden allemaal geaccepteerd
`product`	latest \| top \| media = latest	Welke resultatenset te lezen: `latest`, `top` of `media`
`count`	int 1–100 = 20	Gevraagde paginagrootte; X behandelt dit als een hint, en het `media`-product kan er meer teruggeven
`cursor`	string	Uit `next_cursor` van de vorige pagina; stop wanneer die `null` is
`since`	int (unix seconds)	Unix-seconden; alleen berichten gepubliceerd op of na dit tijdstip (aan de query toegevoegd als `since_time:`)
`until`	int (unix seconds)	Unix-seconden; alleen berichten gepubliceerd vóór dit tijdstip (aan de query toegevoegd als `until_time:`)

antwoord

De effectieve query zoals verzonden (met eventuele since_time:- / until_time:-operatoren), het product, de overeenkomende berichten en next_cursor voor de volgende pagina; de eerste pagina zonder berichten is het einde van de resultaten en geeft next_cursor null terug. Veld voor veld: Tweet (lezen).

Status: 200, 400, 422, 429, 502

verzoek

curl https://api.xsignalfeed.com/v1/search?q=from%3AReuters&product=latest&count=10&since=1789009347&until=1789614147 \
  -H "Authorization: Bearer xsf_your_key"

antwoord · 200 / 400

{
  "query": "from:Reuters since_time:1789009347 until_time:1789614147",
  "product": "latest",
  "tweets": [
    {
      "id": 2100419550890094758,
      "created_ms": 1789614019497,
      "user_id": 1652541,
      "user": "Reuters",
      "name": "Reuters",
      "text": "…",
      "lang": "en",
      "reply_to": null,
      "reply_to_status_id": null,
      "reply_to_user_id": null,
      "conversation_id": "2100419550890094758",
      "is_rt": false,
      "rt_of": null,
      "is_quote": false,
      "quoted": null,
      "media": [],
      "media_items": [],
      "urls": [
        "https://reut.rs/…"
      ],
      "views": "8482",
      "counts": {
        "reply": 0,
        "rt": 1,
        "like": 3,
        "quote": 0,
        "bookmark": 1
      },
      "source": "<a href=\"https://trueanthem.com\" rel=\"nofollow\">trueanthem_pro2</a>"
    },
    {
      "…": "…"
    }
  ],
  "next_cursor": "DAADDAABCgABHSYwc_oW8KYK…"
}