Posts & videosX (Twitter / 推特)Article · Detail
X article detail
Read one public X Article as structured text blocks and public metrics.
POST
/v1/x/articles/detailChinese name: X Article 详情 · 文章 · 详情 读取一条公开 X Article 的结构化正文与互动快照。x.articles.detail@v1
Price per call
¥0.01/ call
Complete and empty results are charged; partial results and failures are not.
Checking live statusTry it
This API is coming soon
We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.
Available now on the same platform
- X post detail
- X thread context
- X list tweets
- X community detail
- X community tweets
- X post search
- X user profile
- X user posts
- X post replies
- X post quotes
- X user search
- X user followers
- X user following
- X retweeters
- X trends
- X user replies
- X user media
- X user mentions
- X batch user detail
- X verified followers
- X bulk follower IDs
- X community members
Sign in and run one real call. The result and charge appear right here.
Security check
Loading the security check…
Checking live execution status…
Execution result
// Result
Request parameters
tweet_idstringrequiredpattern: "^[0-9]{1,20}$"
Example:
"1905545699552375179"
Request JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"tweet_id": {
"type": "string",
"pattern": "^[0-9]{1,20}$"
}
},
"required": [
"tweet_id"
],
"additionalProperties": false
}Code samples
Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.
curl -X POST https://api.dataxapi.com/v1/x/articles/detail \
-H "Authorization: Bearer $DATAXAPI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"tweet_id":"1905545699552375179"}'import { ExactApiClient } from "@dataxapi/sdk";
const client = new ExactApiClient({
baseUrl: "https://api.dataxapi.com",
apiKey: process.env.DATAXAPI_API_KEY,
});
const result = await client.call("x_articles_detail_v1", {
"tweet_id": "1905545699552375179"
});
console.log(result.data);import os
from dataxapi import ExactApiClient
client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
result = client.call("x_articles_detail_v1", {
"tweet_id": "1905545699552375179",
})
print(result["data"])[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"Response example
200 · application/json
{
"code": 200,
"request_id": "req_example_x_articles_detail",
"message": "success",
"data": {
"item": {
"id": "1905545699552375179",
"title": "A public fixture article",
"preview_text": "A short public preview.",
"cover_url": "https://pbs.twimg.com/media/article.jpg",
"created_at": "Fri Mar 28 09:01:12 +0000 2025",
"author": {
"id": "4398626122",
"username": "OpenAI",
"name": "OpenAI",
"description": "Public fixture profile",
"location": "San Francisco",
"avatar_url": "https://pbs.twimg.com/profile_images/openai.jpg",
"header_url": "https://pbs.twimg.com/profile_banners/openai.jpg",
"created_at": "Thu Dec 10 01:03:29 +0000 2015",
"verified": true,
"verified_type": null,
"followers_count": 4000000,
"following_count": 4,
"posts_count": 8000,
"media_count": 1000
},
"metrics": {
"replies": 3,
"likes": 40,
"quotes": 2,
"views": 500
},
"contents": [
{
"text": "First public text block"
}
]
}
},
"page": {
"next_cursor": null
},
"warnings": [],
"meta": {
"listing_id": "x.articles.detail",
"version": "v1",
"catalog_release_id": "catalog-production-2026-09-19.b069be57",
"price_book_version": "pricebook-production-2026-09-19.4487e352",
"result_status": "complete",
"charged_amount": "0.01",
"balance_after": "1.00",
"currency": "CNY"
}
}Response fields
codenumber- const: 200
request_idstringmessagestring- const: "success"
dataobjectpageobjectwarningsarraymetaobject
Response JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"code": {
"type": "number",
"const": 200
},
"request_id": {
"type": "string"
},
"message": {
"type": "string",
"const": "success"
},
"data": {
"type": "object",
"properties": {
"item": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
"title": {
"type": "string"
},
"preview_text": {
"type": "string"
},
"cover_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"author": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"header_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"verified_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"followers_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"following_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"posts_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"media_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"username",
"name",
"description",
"location",
"avatar_url",
"header_url",
"created_at",
"verified",
"verified_type",
"followers_count",
"following_count",
"posts_count",
"media_count"
],
"additionalProperties": false
},
"metrics": {
"type": "object",
"properties": {
"replies": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"quotes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"views": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"replies",
"likes",
"quotes",
"views"
],
"additionalProperties": false
},
"contents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
}
},
"required": [
"text"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"title",
"preview_text",
"cover_url",
"created_at",
"author",
"metrics",
"contents"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"item"
],
"additionalProperties": false
},
"page": {
"type": "object",
"properties": {
"next_cursor": {
"type": "null"
}
},
"required": [
"next_cursor"
],
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"const": "x.articles.detail"
},
"version": {
"type": "string",
"const": "v1"
},
"catalog_release_id": {
"type": "string",
"minLength": 1
},
"price_book_version": {
"type": "string",
"minLength": 1
},
"result_status": {
"type": "string",
"enum": [
"complete",
"empty",
"partial"
]
},
"charged_amount": {
"type": "string"
},
"balance_after": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
}
},
"required": [
"listing_id",
"version",
"catalog_release_id",
"price_book_version",
"result_status",
"charged_amount",
"balance_after",
"currency"
],
"additionalProperties": false
}
},
"required": [
"code",
"request_id",
"message",
"data",
"page",
"warnings",
"meta"
],
"additionalProperties": false
}Usage notes
Good for
- Use this for the matching public X workflow.
Not for
- Do not use it for private data, exhaustive archives, or representative audience claims.
Known limitations
- A regular, unavailable, or nonexistent Tweet can return a confirmed empty item.
- Text blocks do not preserve the complete rich-text layout or embedded components.
- Each call reads one Article; comments, quotes, and the author's other content are not included.
Billing
¥0.01 per call. Complete and empty results are charged; partial results and failures are not.
See all pricing →