Get Twitter Article API

Fetch full Twitter/X article and note content by tweet ID via API. $0.001 per call. GetXAPI article endpoint with rich text and media.

GET/twitter/tweet/article

This endpoint costs $0.001 per API call.

Query Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Tweet ID of the article/note

Notes

Returns the full article/note content for a given tweet ID.
The tweet must be an article tweet (e.g. x.com/i/article/...). Regular tweets will return 404.
contents is an array of rich text blocks with types: unstyled, header-two, header-three, image (with url, width, height), divider, blockquote, ordered-list-item, unordered-list-item.
Text blocks may include inlineStyleRanges for formatting (Bold, Italic).

Response (200)

{
  "status": "success",
  "msg": "success",
  "article": {
    "id": "QXJ0aWNsZUVudGl0eToxOTA1NTQxMTM5MTQ0Mjk4NDk4",
    "author": {
      "type": "user",
      "userName": "Decentralisedco",
      "url": "https://x.com/Decentralisedco",
      "twitterUrl": "https://twitter.com/Decentralisedco",
      "id": "1764631141926002689",
      "name": "DCo",
      "isVerified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "profilePicture": "https://pbs.twimg.com/profile_images/..._normal.jpg",
      "coverPicture": "https://pbs.twimg.com/profile_banners/...",
      "description": "Investments and Research.",
      "location": "Subscribe →",
      "followers": 13657,
      "following": 325,
      "canDm": true,
      "createdAt": "Mon Mar 04 12:37:18 +0000 2024",
      "favouritesCount": 1620,
      "statusesCount": 1053,
      "mediaCount": 487,
      "pinnedTweetIds": ["2029569587029934133"]
    },
    "replyCount": 16,
    "likeCount": 160,
    "quoteCount": 8,
    "viewCount": 44300,
    "createdAt": "Fri Mar 28 09:01:12 +0000 2025",
    "title": "When Tokens Burn",
    "preview_text": "Breaking down how crypto protocols approach revenue and cash flow...",
    "cover_media_img_url": "https://pbs.twimg.com/media/GnHXrznXUAEs-v5.jpg",
    "contents": [
      {
        "type": "unstyled",
        "text": "Breaking down how crypto protocols approach revenue and cash flow",
        "inlineStyleRanges": [{ "length": 65, "offset": 0, "style": "Italic" }]
      },
      { "type": "header-two", "text": "The Zero-Sum Attention Game" },
      {
        "type": "unstyled",
        "text": "In 2021, each crypto asset had, on average, ~$1.8M in stablecoin liquidity..."
      },
      {
        "type": "image",
        "url": "https://pbs.twimg.com/media/GnHZB47WwAAb6hU.png",
        "width": 2040,
        "height": 1372
      },
      { "type": "divider" },
      { "type": "blockquote", "text": "One key insight here is..." },
      {
        "type": "ordered-list-item",
        "text": "First point",
        "inlineStyleRanges": [{ "length": 5, "offset": 0, "style": "Bold" }]
      }
    ]
  }
}

Error Responses

404 - Not an article tweet

{
  "error": "No article found for tweet: 2019264360682778716"
}

Examples

curl -X GET "https://api.getxapi.com/twitter/tweet/article?id=1905545699552375179" \
  -H "Authorization: Bearer API_KEY"

const response = await fetch(
  "https://api.getxapi.com/twitter/tweet/article?id=1905545699552375179",
  {
    headers: {
      Authorization: "Bearer API_KEY",
    },
  }
);
const data = await response.json();
console.log(data.article);

import requests

response = requests.get(
    "https://api.getxapi.com/twitter/tweet/article",
    headers={"Authorization": "Bearer API_KEY"},
    params={"id": "1905545699552375179"},
)
print(response.json()["article"])

Get Article