Tweets

Get a post

GET /v1/tweets/{tweet_id} reads 1 credits

One post and its replies. The id is the number after /status/ in the post's link: 2107511965006622972 in https://x.com/cz_binance/status/2107511965006622972. A repost carries its original in rt_of and a quote the quoted post in quoted, each with its full text and media; to get one of those in full detail as well (its counts, for example), ask for its id.

Query parameters

Query parameter	Type	Meaning
`replies_limit`	int 0–100 = 20	How many replies to include

response

The post and up to replies_limit replies to it. A non-numeric id is 422. Field by field: Tweet (read).

Status: 200, 404, 422, 429, 502

request

curl https://api.xsignalfeed.com/v1/tweets/2099875660290228642?replies_limit=2 \
  -H "Authorization: Bearer xsf_your_key"

response · 200 / 404

{
  "tweet": {
    "id": 2099875660290228642,
    "created_ms": 1789484345873,
    "user_id": 44196397,
    "user": "elonmusk",
    "name": "Elon Musk",
    "text": "Live demo of building a company with @Grok @Bot!",
    "lang": "en",
    "reply_to": null,
    "reply_to_status_id": null,
    "reply_to_user_id": null,
    "conversation_id": "2099875660290228642",
    "is_rt": false,
    "rt_of": null,
    "is_quote": true,
    "quoted": {
      "id": "2099871914655424894",
      "user": "poteto",
      "name": "lauren",
      "user_id": "2832427459",
      "text": "going live in about an hour!\n\n…",
      "media": [],
      "media_items": [],
      "created_ms": 1789483452844,
      "url": "https://x.com/poteto/status/2099871914655424894"
    },
    "media": [],
    "media_items": [],
    "urls": [],
    "views": "28720489",
    "counts": {
      "reply": 2323,
      "rt": 2244,
      "like": 22995,
      "quote": 177,
      "bookmark": 3136
    },
    "article": null,
    "edit_of": null,
    "edit_ids": [
      2099875660290228642
    ],
    "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>"
  },
  "replies": [
    {
      "id": 2099876100000000000,
      "user": "someone",
      "text": "…",
      "reply_to": "elonmusk",
      "reply_to_status_id": "2099875660290228642",
      "…": "…"
    }
  ]
}