用户推文时间线分页

依序拉取指定博主历史发表的推文与转推时间线，支持游标持续拉取。

返回 API 接口列表

/Timeline Endpoints

TwexAPI REST

POST/twitter/{screen_name}/timeline/page

API 鉴权

AuthorizationBearer token · header必填

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

路径参数

screen_namestring必填

目标用户的推特用户名（Handle，无需包含 @）

请求体

必填application/json

next_cursorstring | any

用于拉取下一页数据的游标（Cursor）。当 has_next_page 为 true 时将此值作为下一页的 cursor 参数传入

展开属性

Any of:

string

string

any

any

countinteger

要获取的记录数量上限

min 1 · max 100 · default: 20

响应结果

200当前页数据对象及分页游标元数据（has_next_page, next_cursor）。

codeinteger

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

default: 200

msgstring

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

default: "success"

dataUserTweetItem[]必填

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

展开属性

Array of UserTweetItem

tweet_idstring必填

推文唯一数字 ID

is_paid_promotionboolean

该推文是否被标记为商业广告或付费赞助推广内容

default: false

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

conversation_idstring | any

私信会话窗口唯一标识符

展开属性

Any of:

string

string

any

any

bookmark_countinteger

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

default: 0

favorite_countinteger

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

default: 0

reply_countinteger

推文收到的评论回复总数

default: 0

retweet_countinteger

推文被转发的累计总数

default: 0

quote_countinteger

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

default: 0

view_countstring | any

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

展开属性

Any of:

string

string

any

any

view_count_statestring | any

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

展开属性

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

has_next_pageboolean必填

是否存在下一页数据（true 表示还有更多数据）

next_cursorstring | any

用于拉取下一页数据的游标（Cursor）。当 has_next_page 为 true 时将此值作为下一页的 cursor 参数传入

展开属性

Any of:

string

string

any

any

requested_countinteger必填

客户端发起的原始目标请求数量。

effective_countinteger必填

根据账户额度限制策略节流后的最终返回数量。

parsed_countinteger必填

从响应中成功解析出的推文实际数量。

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

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

typestring必填

inputany

ctxobject

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

Live Console

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

● 生产环境就绪

🔍

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

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

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

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

⚙️请求参数 (1)

screen_namepath

必填目标用户的推特用户名（Handle，无需包含 @）

📝请求体application/json

next_cursorstring

可选用于拉取下一页数据的游标（Cursor）。当 has_next_page 为 true 时将此值作为下一页的 cursor 参数传入

countinteger

可选要获取的记录数量上限

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

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

请求示例

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

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

import requests

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

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "tweet_id": "string",
      "is_paid_promotion": false,
      "full_text": "string",
      "created_at": "string",
      "lang": "string",
      "conversation_id": "string",
      "bookmark_count": 0,
      "favorite_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "quote_count": 0,
      "view_count": "string",
      "view_count_state": "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
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAAHCgABHFeD5h9__-cLAAIAAAATMjAzODIzMzA5NTM4ODY4MDU5NAgAAwAAAAIAAA",
  "requested_count": 0,
  "effective_count": 0,
  "parsed_count": 0
}

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