Get Tweets by IDs (Batch) API

Look up to 100 tweets by ID in one API call. $0.002 per request. GetXAPI batch tweet lookup endpoint with response examples.

GET/twitter/tweet/batch_detail

This endpoint costs $0.002 per request, for up to 100 tweet ids.

Query Parameters

Parameter	Type	Required	Description
`tweet_ids`	string	Yes	Comma-separated tweet ids, up to 100. `tweetIds` and `ids` are accepted as aliases, and repeated params (`ids=1&ids=2`) work too.

Notes

Returns up to 100 tweets in one call. Each tweet has the same fields as Tweet Detail.
Tweets come back in the order you requested them. Duplicate ids are counted once.
Ids that can't be returned (deleted, protected, from a suspended account, or never existed) are listed in not_found, so every id you sent is accounted for.
The price is per request, whether you send 1 id or 100, and whether or not every id is found. For a single tweet, Tweet Detail costs less.

Response (200)

{
  "status": "success",
  "msg": "success",
  "data": {
    "tweets": [
      {
        "type": "tweet",
        "id": "2019264360682778716",
        "url": "https://x.com/elonmusk/status/2019264360682778716",
        "twitterUrl": "https://twitter.com/elonmusk/status/2019264360682778716",
        "text": "@Gaurab Yes, it is extremely difficult",
        "source": "Twitter for iPhone",
        "retweetCount": 180,
        "replyCount": 452,
        "likeCount": 6783,
        "quoteCount": 20,
        "viewCount": 525585,
        "createdAt": "Thu Feb 05 04:18:34 +0000 2026",
        "lang": "en",
        "bookmarkCount": 171,
        "isReply": true,
        "inReplyToId": "2019199325365227607",
        "conversationId": "2019199325365227607",
        "media": [],
        "inReplyToUserId": "18433952",
        "author": {
          "type": "user",
          "userName": "elonmusk",
          "url": "https://x.com/elonmusk",
          "id": "44196397",
          "name": "Elon Musk",
          "isVerified": false,
          "isBlueVerified": true,
          "profilePicture": "https://pbs.twimg.com/profile_images/.../aR-Kjpp4_normal.jpg",
          "coverPicture": "https://pbs.twimg.com/profile_banners/44196397/...",
          "description": "https://t.co/ZdBx5WABYx",
          "location": "",
          "followers": 241427817,
          "following": 1420,
          "createdAt": "Tue Jun 02 20:12:29 +0000 2009",
          "canDm": false
        },
        "quoted_tweet": null,
        "retweeted_tweet": null
      }
    ],
    "not_found": ["1999999999999999999"]
  }
}

Error Responses

400 - Missing tweet_ids

{
  "error": "Missing required query param: tweet_ids (comma-separated ids, up to 100)"
}

400 - More than 100 ids

{
  "error": "Too many ids: 101 (max 100 per request)"
}

400 - Invalid id

{
  "error": "Invalid id(s) in tweet_ids: abc (numeric ids only)"
}

Example

curl -H "Authorization: Bearer API_KEY" "https://api.getxapi.com/twitter/tweet/batch_detail?tweet_ids=2019264360682778716,1999999999999999999"

Batch Tweet Detail