Skip to main content
POST
X Articles API

X Articles

Read X Articles, the long-form posts with a title, cover image and formatted body, as clean text. Pass the URL of the post that publishes the Article and get back its title, the preview line shown in timelines, the full body with paragraphs separated by blank lines, the cover image, the author and its likes, replies, quotes and views. Use it to archive long-form writing, feed it to a summarizer or language model, or track how Articles perform compared with regular posts.
Provide the X post URLs that publish each Article in urls, using //status/. Each Article returns one row. A post that is not an Article returns no row; when none of the URLs is an Article, the task fails and is not charged.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide the X post URLs that publish each Article in urls, using /{username}/status/{post_id}.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object