Get article
GET/twitter/article
An article (long-form post) by its tweet ID.
Price: $0.0006 per request.
When to use it
- Get the full text of an X Article (long-form post): title, preview, cover image and
contents. - Archive or analyze long-form posts with their likes, replies, quotes and views.
An Article is addressed by its tweet ID, the number after /status/ in its link.
Parameters
tweet_idstringrequiredNumeric tweet ID.
Example:
2082071471548244406
Example request
curl "https://api.cheapxapi.com/twitter/article?tweet_id=2082071471548244406" \
-H "x-api-key: YOUR_KEY"Response
Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.
{
"article": {
"id": "QXJ0aWNsZUVudGl0eToyMDgyMDI0OTk3NDgxMjU5MDA5",
"author": {
"type": "user",
"userName": "balajis",
"url": "https://x.com/balajis",
"twitterUrl": "https://twitter.com/balajis",
"id": "2178012643",
"name": "Balaji",
"isVerified": false,
"isBlueVerified": true,
"verifiedType": null,
"profilePicture": "https://pbs.twimg.com/profile_images/2049168417710915585/egYgw1FA_normal.jpg",
"coverPicture": "https://pbs.twimg.com/profile_banners/2178012643/1761485965",
"description": "Author of the Network State. Founder of the Network School.",
"location": "Network School",
"followers": 2266166,
"following": 3933,
"status": "",
"canDm": true,
"canMediaTag": false,
"createdAt": "Wed Nov 06 12:51:04 +0000 2013",
"entities": {
"description": {},
"url": {
"urls": [
{
"display_url": "ns.com",
"expanded_url": "https://ns.com",
"indices": [
0,
23
],
"url": "https://t.co/HhDUsvgg0o"
}
]
}
},
"fastFollowersCount": 0,
"favouritesCount": 278232,
"hasCustomTimelines": false,
"isTranslator": false,
"mediaCount": 5574,
"statusesCount": 31212,
"withheldInCountries": [],
"affiliatesHighlightedLabel": {
"label": {
"badge": {
"url": "https://pbs.twimg.com/profile_images/1978800279165558784/9_D3CwAc_bigger.jpg"
},
"description": "NS",
"url": {
"url": "https://twitter.com/ns",
"urlType": "DeepLink"
},
"userLabelDisplayType": "Badge",
"userLabelType": "BusinessLabel"
}
},
"possiblySensitive": false,
"pinnedTweetIds": [
"2108596569201397803"
],
"profile_bio": {},
"isAutomated": false,
"automatedBy": null
},
"replyCount": 114,
"likeCount": 799,
"quoteCount": 55,
"viewCount": "306432",
"createdAt": "Tue Jul 28 11:51:36 +0000 2026",
"title": "Why did Stu Woo of the Wall Street Journal Follow Me to Singapore?",
"preview_text": "A writer named Stu Woo recently moved from San Francisco to Singapore. He got in touch to ask me why I’d also moved from San Francisco to Singapore, and why I’d decided to become a proud Singaporean.",
"cover_media_img_url": "https://pbs.twimg.com/media/HOTXr2_WIAAodUr.jpg",
"contents": [
{
"type": "unstyled",
"text": "A writer named Stu Woo recently moved from San Francisco to Singapore. He got in touch to ask me why I’d also moved from San Francisco to Singapore, and why I’d decided to become a proud Singaporean. We talked about the reasons he and others had moved away from America — the old …",
"inlineStyleRanges": [
{
"length": 4,
"offset": 105,
"style": "Italic"
}
]
}
]
},
"status": "success",
"msg": "success"
}A real response to the example request above. Lists are shortened, long text is cut, and accounts with fewer than 100,000 followers are anonymized.
| Field | Type |
|---|---|
article | object |
author | UserInfo |
replyCount | integer |
likeCount | integer |
quoteCount | integer |
viewCount | integer |
createdAt | string |
title | string |
preview_text | string |
cover_media_img_url | string |
contents | array of object |
status | "success" | "failed" |
msg | string |
Status codes
- 200
- Charged. Check
status:successmeans data was returned;error(e.g. user not found) is also HTTP 200. - 400
- Invalid parameters (charged), or API key placed in the URL (not charged).
- 401
- Missing or invalid API key (not charged).
- 402
- Insufficient balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint (charged), or the requested item could not be found (not charged). Note: many endpoints report a missing user/tweet as HTTP 200 with
"status":"error"instead; those are charged. - 405
- Only GET is supported (not charged).
- 429
- Rate limit exceeded (not charged). Retry after the time in the
Retry-Afterheader. - 503
- Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.