分页获取用户文章

按 screen_name 获取一页 X 文章，仅需 TwexAPI Bearer API Key。请求体可省略；count 省略或为 null 时使用 20，整数会被限制到 1–20。继续分页时原样传入 next_cursor。当前实现仅在解析文章数达到 count 且上游提供游标时返回下一页游标，因此不足一页或空页会结束分页。用户不存在或结果额度耗尽时返回空页。

返回 API 接口列表

/Article Endpoints

TwexAPI REST

POST/twitter/{screen_name}/articles/page

API 鉴权

AuthorizationBearer token · header必填

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

路径参数

screen_namestring必填

X username with or without @.

matches \S

请求体

application/json

Any of:

object

countinteger | any

Omitted or null uses 20. Values below 1 are clamped to 1 and values above 20 to 20.

default: 20

展开属性

Any of:

integer

integer

any

any

next_cursorstring | any

展开属性

Any of:

string

string

any

any

any

any

响应结果

200Success

codeinteger必填

msgstring必填

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 数组

has_next_pageboolean必填

next_cursorstring | any必填

展开属性

Any of:

string

string

any

any

403Authentication or credit access denied

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

422Invalid request

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

500Upstream or server error

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

⚡交互式测试 / Try APIPOST/twitter/{screen_name}/articles/page

Live Console

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

● 生产环境就绪

🔍

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

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

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

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

⚙️请求参数 (1)

screen_namepath

必填X username with or without @.

📝请求体application/json

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

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

请求示例

curl -X POST "https://api.twexapi.io/twitter/example_user/articles/page" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 20,
  "next_cursor": null
}'

const response = await fetch("https://api.twexapi.io/twitter/example_user/articles/page", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "count": 20,
  "next_cursor": null
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/example_user/articles/page",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "count": 20,
  "next_cursor": None
},
)

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [],
  "has_next_page": false,
  "next_cursor": null
}

{
  "code": 403,
  "msg": "Authentication or credit access denied",
  "data": []
}

{
  "code": 422,
  "msg": "Invalid request",
  "data": []
}

{
  "code": 500,
  "msg": "Upstream or server error",
  "data": []
}