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
| Parameters | Required | Description |
|---|---|---|
urls | Required | One 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.
- POST {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} to /v1/x/article.
- Poll GET /v1/tasks/{task_id} until the X Articles API task status reads succeeded.
- 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.
Related APIs
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.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API