批量查询 X 长文章

根据文章 ID 数组批量拉取长文章的完整结构化元数据。

返回 API 接口列表

/Article Endpoints

TwexAPI REST

POST/x/article

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

请求体

必填application/json

Array of string

string

响应结果

200包含每个有效 ID 对应详细数据的长文章对象列表。

codeinteger必填

HTTP 响应状态码（200 表示成功）

msgstring必填

响应提示信息（例如 'success'）

dataXArticleModel[]必填

接口返回的核心业务数据载荷

展开属性

Array of XArticleModel

tweet_idstring | any

推文唯一数字 ID

展开属性

Any of:

string

string

any

any

full_textstring | any

推文的完整正文文本

展开属性

Any of:

string

string

any

any

created_atstring | any

发布或创建时间（UTC 标准时间格式）

展开属性

Any of:

string

string

any

any

langstring | any

推文主要语言代码（如 'zh', 'en', 'ja' 等）

展开属性

Any of:

string

string

any

any

bookmark_countinteger | any

推文被用户加入书签收藏的累计次数

展开属性

Any of:

integer

integer

any

any

favorite_countinteger | any

推文获赞（Favorite/Like）累计总数

展开属性

Any of:

integer

integer

any

any

reply_countinteger | any

推文收到的评论回复总数

展开属性

Any of:

integer

integer

any

any

retweet_countinteger | any

推文被转发的累计总数

展开属性

Any of:

integer

integer

any

any

quote_countinteger | any

推文被引用转发（Quote Tweet）的累计总数

展开属性

Any of:

integer

integer

any

any

view_countstring | any

推文的实际总浏览/阅读次数（Impression）

展开属性

Any of:

string

string

any

any

view_count_statestring | any

浏览量统计状态（Enabled 表示已启用计数）

展开属性

Any of:

string

string

any

any

conversation_idstring | any

私信会话窗口唯一标识符

展开属性

Any of:

string

string

any

any

author_user_idstring | any

推文作者的推特数字用户 ID

展开属性

Any of:

string

string

any

any

author_screen_namestring | any

推文作者的推特用户名（Handle，无需包含 @）

展开属性

Any of:

string

string

any

any

author_namestring | any

推文作者的昵称/显示名称

展开属性

Any of:

string

string

any

any

author_is_blue_verifiedboolean | any

作者是否拥有推特蓝 V 认证（X Premium）

展开属性

Any of:

boolean

boolean

any

any

author_verifiedboolean | any

作者是否拥有推特官方认证徽章

展开属性

Any of:

boolean

boolean

any

any

author_is_verified_organization_affiliateboolean | any

作者是否为企业官方认证关联账号

展开属性

Any of:

boolean

boolean

any

any

article_idstring | any

X 长文章的唯一标识符

展开属性

Any of:

string

string

any

any

article_titlestring | any

X 长文章的主标题文本

展开属性

Any of:

string

string

any

any

article_preview_textstring | any

长文章前导预览摘要文字

展开属性

Any of:

string

string

any

any

article_summary_textstring | any

长文章内容提要总结

展开属性

Any of:

string

string

any

any

article_cover_image_urlstring | any

长文章封面头图的公开 URL 地址

展开属性

Any of:

string

string

any

any

article_blocksArticleBlock[]

长文章由富文本段落构成的块（Blocks）数据结构

展开属性

Array of ArticleBlock

typestring必填

文章段落块的类型（如段落、标题等）。

textstring必填

文本正文内容

entityRangesArticleBlockRange[]

文章段落块的实体高亮/链接范围。

展开属性

Array of ArticleBlockRange

keyinteger必填

实体范围对应的索引 Key。

lengthinteger必填

实体范围的字符长度。

offsetinteger必填

实体范围在段落中的起始偏移量（Offset）。

article_plain_textstring | any

长文章去除格式后的纯文本内容

展开属性

Any of:

string

string

any

any

article_markdownstring | any

长文章格式化后的纯净 Markdown 文本（极度适合大模型 RAG 语料提取）

展开属性

Any of:

string

string

any

any

article_media_image_urlsstring[]

长文章内嵌入的插图图片公开 URL 数组

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

响应提示信息（例如 'success'）

typestring必填

inputany

ctxobject

⚡交互式测试 / Try APIPOST/x/article

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

📝请求体application/json

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X POST "https://api.twexapi.io/x/article" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "1803006263529541838",
  "1803006263529541839"
]'

const response = await fetch("https://api.twexapi.io/x/article", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "1803006263529541838",
  "1803006263529541839"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/x/article",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "1803006263529541838",
  "1803006263529541839"
],
)

响应示例

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "tweet_id": "string",
      "full_text": "string",
      "created_at": "string",
      "lang": "string",
      "bookmark_count": 0,
      "favorite_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "quote_count": 0,
      "view_count": "string",
      "view_count_state": "string",
      "conversation_id": "string",
      "author_user_id": "string",
      "author_screen_name": "string",
      "author_name": "string",
      "author_is_blue_verified": true,
      "author_verified": true,
      "author_is_verified_organization_affiliate": true,
      "article_id": "string",
      "article_title": "string",
      "article_preview_text": "string",
      "article_summary_text": "string",
      "article_cover_image_url": "string",
      "article_blocks": [
        {
          "type": "string",
          "text": "string",
          "entityRanges": [
            {
              "key": 0,
              "length": 0,
              "offset": 0
            }
          ]
        }
      ],
      "article_plain_text": "string",
      "article_markdown": "string",
      "article_media_image_urls": [
        "string"
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}