Get X article

5 credits per call · All plans from $0.00012/credit · Accepts MPP

Get X Article returns one long-form X Article by wrapper tweet ID. It is also useful as an X article API, Twitter article API, tweet article API, long-form post API, or article body endpoint. The canonical endpoint remains GET /api/v1/x/articles/{tweetId}.

curl https://xquik.com/api/v1/x/articles/2033891852621840387 \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The examples shape durable article handoff rows instead of raw lookup dumps. Use GET /api/v1/x/articles/{tweetId} when a workflow needs one long-form post body plus article metadata. Store tweet_id, article_title, preview_text, author_id, author_username, author_name, author_profile_picture, created_at, cover_image_url, and body_text with the downstream record. Store block_count and media_urls when your archive, content pipeline, or agent handoff needs block-level completeness checks.

Find candidate articles

Use this endpoint after you have the numeric wrapper tweet ID for an X Article. When a workflow starts from a mixed set of tweets, search first, store candidate tweet IDs, then try the article lookup once per candidate.

Search first

Use Search tweets to find candidate wrapper tweets by author, keyword, URL, or visible tweet text.

Article lookup

Call GET /api/v1/x/articles/{tweetId} with the candidate tweet ID when the workflow needs the long-form body.

Fallback route

If the response is article_not_found, store the terminal result and switch to Get tweet or Get tweet thread.

Saved export

Use article_extractor when the workflow needs an extraction job, estimate, or CSV/JSON/XLSX export.

{
  "content_job_id": "article-archive-q2",
  "candidate_source": "GET /api/v1/x/tweets/search",
  "article_route": "GET /api/v1/x/articles/{tweetId}",
  "tweet_id": "2033891852621840387",
  "content_type": "x_article",
  "article_error": null,
  "fallback_route": "GET /api/v1/x/tweets/{id}",
  "saved_fields": ["article_title", "preview_text", "body_text", "cover_image_url"]
}

Direct article handoff

Use GET /api/v1/x/articles/{tweetId} when you have the numeric tweet ID for an X Article wrapper tweet and need the article body. Use the final status ID from an X Article URL. A normal tweet ID can be valid and still return 404 article_not_found when it is not an X Article.

Article row

Store article.title, previewText, coverImageUrl, createdAt, metrics, and a derived body_text field.

Body blocks

Store article.contents[] when you need headings, lists, quotes, media, dividers, code blocks, and inline styles.

Author joins

Store author.id, username, name, and profilePicture when returned.

Media assets

Store coverImageUrl and media-block url values for article archives and content review.

Not an article

Treat article_not_found as a terminal lookup result for that tweet ID. Ask for an X Article URL or use a tweet/thread endpoint.

Saved exports

Use article_extractor when you need a saved extraction job or CSV, JSON, or XLSX export.

Direct article reads cost 5 credits per successful call. For MPP callers, this endpoint is billed as a fixed charge at USD 0.00105 per call.

Path parameters

tweetId

string

required

Numeric tweet ID of the X Article, 15-20 digits. If you have a tweet URL, use the final status ID. Regular tweet URLs can return article_not_found.

Which article endpoint?

X article body

Use GET /x/articles/{tweetId} for the title, body blocks, cover image, metrics, and author fields of one X Article.

Single tweet

Use Get tweet for one tweet’s text, media, author, and engagement metrics.

Tweet thread

Use Get tweet thread for conversation context around the article wrapper tweet.

Search tweets

Use Search tweets to discover candidate article tweets by keyword, URL, author, or other filters.

Saved exports

Use Create extraction with toolType=article_extractor when you need a saved job or CSV, JSON, or XLSX export.

Article-not-found handling

Do not retry the same ID after article_not_found; switch to tweet lookup or ask for an X Article URL.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

article

object

The article data.

Show article object

title

string

Article title.

previewText

string

Short preview/summary text of the article.

coverImageUrl

string

Cover thumbnail image URL.

contents

object[]

Article body as an array of content blocks.

Show content block

type

string

Block type: paragraph, header-one, header-two, header-three, header-four, header-five, header-six, ordered-list-item, unordered-list-item, blockquote, code-block, media, or divider.

text

string

Text content for text-based blocks.

url

string

Media URL for media blocks.

previewUrl

string

Preview image URL for media blocks.

width

number

Image width in pixels.

height

number

Image height in pixels.

inlineStyleRanges

object[]

Inline text formatting.

Show style range

offset

number

Character offset where the style starts.

length

number

Number of characters the style spans.

style

string

Draft.js style token such as BOLD or ITALIC.

createdAt

string

Article creation timestamp.

likeCount

number

Like count.

replyCount

number

Reply count.

quoteCount

number

Quote tweet count.

viewCount

number

View count.

author

object

The article author. Omitted if author data is unavailable.

Show author object

string

Author user ID.

username

string

Author X username.

name

string

Author display name.

profilePicture

string

Profile picture URL. Omitted if unavailable.

{
  "article": {
    "title": "Why Your TikTok & Instagram Videos Aren't Getting Views",
    "previewText": "Creating organic videos for Instagram Reels and TikTok is one of the most effective ways to attract customers...",
    "coverImageUrl": "https://pbs.twimg.com/media/HDcia3lXsAASgbQ.jpg",
    "contents": [
      {
        "type": "paragraph",
        "text": "Creating organic videos for Instagram Reels and TikTok is one of the most effective ways to attract customers."
      },
      {
        "type": "header-two",
        "text": "The problem"
      },
      {
        "type": "ordered-list-item",
        "text": "Your account isn't properly set up"
      },
      {
        "type": "media",
        "url": "https://pbs.twimg.com/media/HDm1eekbQAAzP9c.png",
        "previewUrl": "https://pbs.twimg.com/media/HDm1eekbQAAzP9c.png",
        "width": 640,
        "height": 804
      },
      {
        "type": "paragraph",
        "text": "What really matters is the hook.",
        "inlineStyleRanges": [
          { "offset": 23, "length": 8, "style": "BOLD" }
        ]
      }
    ],
    "createdAt": "Tue Mar 17 13:03:00 +0000 2026",
    "likeCount": 156,
    "replyCount": 9,
    "quoteCount": 4,
    "viewCount": 71303
  },
  "author": {
    "id": "1857516996755165184",
    "username": "cesaralvarezll",
    "name": "César Álvarez",
    "profilePicture": "https://pbs.twimg.com/profile_images/1884934857567895553/hHWR_iBg_normal.jpg"
  }
}

{ "error": "invalid_tweet_id" }

The provided tweet ID is empty or not a valid format.

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits. For MPP requests without a valid payment credential, 402 returns a WWW-Authenticate: Payment challenge header instead.

{ "error": "article_not_found", "message": "Article not found. Use an X Article tweet ID." }

The tweet is valid but does not contain an X Article.

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

Your tier rate limit was exceeded. Wait for the Retry-After header before retrying.

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Related: Get tweet · Get tweet thread · Search tweets · Create extraction

Documentation Index

​Find candidate articles

Search first

Article lookup

Fallback route

Saved export

​Direct article handoff

Article row

Body blocks

Author joins

Media assets

Not an article

Saved exports

​Path parameters

​Which article endpoint?

X article body

Single tweet

Tweet thread

Search tweets

Saved exports

Article-not-found handling

​Headers

​Response

Find candidate articles

Direct article handoff

Path parameters

Which article endpoint?

Headers

Response