x/
article

The X Articles API pulls the complete text of X Articles from the URLs of the posts that publish them, with title, timeline preview, cover image, author and engagement, paragraph breaks kept.

X Articles API

Post URL input
Full Article body
Title, preview and cover
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

X Articles

X Articles, still often called Twitter articles, are long-form posts that Premium subscribers publish with a title, a cover image and a formatted body, shown in timelines as a short preview and collecting likes, replies, quotes and views like any other post. Holding the title, preview and whole body as text next to those counts makes it possible to archive long-form writing, summarise or classify it, and compare how Articles perform against an author's regular posts.

X Articles API Features

  • Article posts by URLSend one or more links to the tweets that publish Articles, in the x.com/{username}/status/{post_id} form, and each Article returns one row whose id and url belong to that post.
  • Full body as plain textIn the X Articles API response, text holds the entire Article with a blank line between paragraphs, ready to split into paragraphs or pass to a reader, search index or language model.
  • Title, preview line and cover imagetitle, summary (the preview X shows in timelines) and cover_url describe the Article the way readers first meet it in their feed.
  • Author and engagementauthor gives the handle, display name, avatar and verified flag, metrics gives likes, replies, quotes and views, and published_at records when the Article went live.

X Articles API Parameters

ParametersRequiredDescription
urlsRequiredOne or more X post URLs in the /{username}/status/{post_id} form, each pointing to the post that publishes an Article.

How to Use the X Articles API

Submit the links of the posts that carry the Articles to the X Articles API, then read one row per Article.

  1. POST {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} to /v1/x/article.
  2. Poll GET /v1/tasks/{task_id} until the X Articles API task status reads succeeded.
  3. Read the Articles from results.items; while has_more is true, send results.next_cursor to get the next page.
curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'

# text holds the whole Article, with a blank line between paragraphs.

X Articles API Use Cases

  • Archiving an author's long-form writing: Save title, text, cover_url, published_at and url for every Article to keep a searchable copy of what an account has published in long form.
  • Summarising Articles with a language model: Split the X Articles API text field on its blank lines and hand the paragraphs to a summariser or language model, with title as context, to turn long Articles into short digests.
  • Comparing Articles with an author's regular posts: Set the views_count, likes_count and quotes_count of an author's Articles beside the same counts on their regular posts to see which format their audience reads and passes on.
  • Following an Article after it goes live: Request the same URL from the X Articles API at intervals and record how views, replies and quotes build up in the days after published_at.
  • Quoting announcements word for word: When an agency, company or founder publishes an announcement as an Article, take exact passages from text and cite them with url and published_at.

X Articles API Pro Tips

  • When you are unsure which posts are Articles, send them to the X Articles API in one batch: only Articles return rows and are charged, and a batch made up entirely of ordinary posts fails with a full refund.
  • Show summary in previews and cards and text in the reading view; summary repeats the opening lines of the body, so joining the two prints that passage twice.
  • Store each Article under id, the ID of the post that publishes it, so collecting the same Article again updates its saved metrics.
  • Report metrics.comments_count as the number of replies to the Article's post when you put Article engagement in a dashboard.

Beyond the X Articles API, use these APIs when you need a different type of public X data.

  • Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
  • Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
  • Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
  • X Post Quotes API — Collect public quote posts for known status URLs with commentary, authors, engagement, media, timestamps, and source-post context.
  • X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
  • Twitter Mentions API — Collect public posts mentioning a specified account.

Explore other platforms

Combine X data with public data from other supported social platforms.

X Articles API — FAQ

X Articles API is a programmatic interface for reading X Articles, the long-form posts with a title and cover image, from the URLs of the posts that publish them. It returns the title, timeline preview, full body text, cover image URL, author and the like, reply, quote and view counts.

X Articles are long-form posts that Premium subscribers can publish on X, with a title, a cover image and a formatted body. They appear in timelines as a post with a short preview, and readers open them to see the whole piece.

Use the link of the post that publishes the Article, in the x.com/{username}/status/{post_id} form. Several links can go into urls at once, and each Article comes back as its own row.

That post returns no row and costs nothing, while the Articles in the same request are still returned. If none of the URLs is an Article, the task fails and is fully refunded.

The cover image is returned in cover_url. Images placed inside the body are not included; text carries the written content only.

Yes. text holds the whole body as plain text with a blank line between paragraphs, which can be saved as a .txt file or used as Markdown paragraphs, with title added on top as the heading.