Tweet Endpoints

Endpoints for fetching individual tweets, conversation threads, quote tweets, and batch lookups.

GET/v2/tweets/:tweetIdLook up a single tweet by its numeric ID.

Parameter	Type	Required	Default	Description
tweetId	string	required	—	The numeric tweet ID (up to 25 digits)

BASH

curl https://xcrop.io/api/v2/tweets/2028500984977330453 \
  -H "Authorization: Bearer $XCROP_API_KEY"

ResponseJSON

{
  "data": {
    "id": "2028500984977330453",
    "text": "Expanding to the stars avoids risk of a mouse utopian behavioral sink",
    "author": {
      "id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk"
    },
    "metrics": {
      "likes": 120167,
      "retweets": 11840,
      "replies": 14280,
      "views": 63267261,
      "bookmarks": 5479
    },
    "is_reply": false,
    "is_quote": false,
    "is_retweet": false,
    "created_at": "Mon Mar 02 16:01:37 +0000 2026"
  },
  "meta": { "latency_ms": 2450 }
}

ℹ

Returns 404 if the tweet does not exist or has been deleted.

GET/v2/tweets/:tweetId/conversationFetch the conversation thread (replies) for a tweet. Promoted posts X injects into the thread are removed, and meta.removed_not_in_conversation counts them.

Parameter	Type	Required	Default	Description
tweetId	string	required	—	The tweet ID to get conversation for
count	integer	optional	20	Number of replies to return
sort	string	optional	latest	Sort: latest, popular, engagement. Invalid values return 400
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/tweets/2028500984977330453/conversation?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

ResponseJSON

{
  "data": [
    {
      "id": "2028501110261211606",
      "text": "https://t.co/MgSa3QQ9GN",
      "author": {
        "id": "44196397",
        "username": "elonmusk",
        "name": "Elon Musk"
      },
      "metrics": {
        "likes": 3538,
        "retweets": 1316,
        "replies": 717,
        "views": 988634,
        "bookmarks": 500
      },
      "is_reply": true,
      "is_quote": false,
      "is_retweet": false,
      "created_at": "Mon Mar 02 16:02:07 +0000 2026"
    }
  ],
  "meta": {
    "total": 20,
    "conversation_id": "2028500984977330453",
    "has_next_page": true,
    "next_cursor": "DAAKCgABHCvTsBf___0...",
    "latency_ms": 2780
  }
}

GET/v2/tweets/:tweetId/quotesGet quote tweets (tweets that quote a specific tweet).

Parameter	Type	Required	Default	Description
tweetId	string	required	—	The tweet ID to get quotes for
count	integer	optional	20	Number of quote tweets to return
sort	string	optional	latest	Sort: latest, popular, engagement
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/tweets/2028500984977330453/quotes?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

POST/v2/tweets/batchLook up multiple tweets by ID in a single request. Max 100 IDs.

Parameter	Type	Required	Default	Description
ids	string[]	required	—	Array of tweet IDs to look up (max 100)

BASH

curl -X POST https://xcrop.io/api/v2/tweets/batch \
  -H "Authorization: Bearer $XCROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["2028500984977330453", "2029940206447776023"]}'

ResponseJSON

{
  "data": [
    {
      "id": "2028500984977330453",
      "text": "Expanding to the stars avoids risk of a mouse utopian behavioral sink",
      "author": { "id": "44196397", "username": "elonmusk", "name": "Elon Musk" },
      "metrics": {
        "likes": 120167, "retweets": 11840,
        "replies": 14280, "views": 63267261, "bookmarks": 5479
      },
      "is_reply": false, "is_quote": false, "is_retweet": false,
      "created_at": "Mon Mar 02 16:01:37 +0000 2026"
    }
  ],
  "meta": { "total": 1, "requested": 2, "latency_ms": 3150 }
}

More in REST API

Full documentation with search: xcrop.io/docs