X Tweet Lookup
GET
/v1/x/tweets/{id}MCP
x_tweet_detail3 creditsLiveUpdated
Description
Fetch one tweet by id or URL with its full text, author profile, engagement counts, media and reply context. Costs 3 credits. Tip: use conversationId with x.replies to read the whole discussion.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
id | path | string | yes | Tweet id or tweet URL. |
- id path, string, required
- Tweet id or tweet URL.
Request examples
curl "https://chatterapi.com/v1/x/tweets/2099495333231288346" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is one XTweet. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | no | Platform id. |
text | string | no | Text. |
url | string | no | Full URL on the platform. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
lang | string | yes | Language code. |
likes | number | yes | Likes. |
retweets | number | yes | Retweets. |
replies | number | yes | Replies. |
quotes | number | yes | Quote tweets. |
views | number | yes | Views. |
bookmarks | number | yes | Bookmarks. |
isReply | boolean | no | Is a reply. |
inReplyToId | string | yes | Tweet this replies to. |
conversationId | string | yes | Root tweet id of the conversation. |
isRetweet | boolean | no | Is a retweet. |
quotedTweetId | string | yes | Tweet this quotes. |
author | object | no | Author profile (XUser). |
media | object[] | no | Images, video or gallery URLs, or null. |
response
{
"data": {
"id": "2099495333231288346",
"text": "meta ads: how important is the “connect to your crm” recommendation?\n\nthis essentially will tell meta if the lead was good or bad (ie converted), any experience how how is actually helps?\n\nthis particular client doesn’t have a crm, yeah, I can build a page for him to update, but is it worth the effort?",
"url": "https://x.com/HesomParhizkar/status/2099495333231288346",
"createdAt": "2026-09-14T13:47:48.000Z",
"lang": "en",
"likes": 2,
"retweets": 0,
"replies": 2,
"quotes": 0,
"views": 139,
"bookmarks": 0,
"isReply": false,
"inReplyToId": null,
"conversationId": "2099495333231288346",
"isRetweet": false,
"quotedTweetId": null,
"author": {
"id": "35363135",
"handle": "HesomParhizkar",
"name": "Hesom",
"bio": "Startup Founder/Executive, investor, nba fan",
"followers": 584,
"following": 2010,
"tweets": null,
"verified": false,
"blueVerified": true,
"canDm": true,
"protected": null,
"location": "Marietta, GA",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/1871033188081942528/comvGkRg_normal.jpg",
"createdAt": "2009-04-26T01:18:19.000Z"
},
"media": []
},
"credits": {
"charged": 3,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.
Credits
3 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.