Skip to content
cheapxapi
All endpoints

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_idstringrequired

    Numeric 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.

Example response
{
  "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.

FieldType
articleobject
authorUserInfo
replyCountinteger
likeCountinteger
quoteCountinteger
viewCountinteger
createdAtstring
titlestring
preview_textstring
cover_media_img_urlstring
contentsarray of object
status"success" | "failed"
msgstring

Status codes

200
Charged. Check status: success means 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-After header.
503
Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.