Skip to main content

​
比较 X API 的时间线端点

v2 的按时间逆序主页时间线、用户 Post 时间线和用户提及时间线端点分别取代了 v1.1 statuses/home_timeine, v1.1 statuses/user_timeline 和 v1.1 statuses/mentions_timeline 端点。如果你在代码、应用或工具中使用了该端点的早期版本，并计划迁移到较新的 X API v2 端点，那么本指南适合你。有关更深入的迁移说明，请参阅Standard v1.1 迁移到 X API v2。 本页包含三张对比表：
  • 按时间逆序的主页时间线
  • 用户 Post 时间线
  • 用户提及时间线

​
主页时间线（按时间倒序）

下表对比了标准 v1.1 与 X API v2 的主页时间线端点：
描述标准 v1.1X API v2
文档API 参考API 参考
支持的 HTTP 方法GETGET
主机域https://api.x.comhttps://api.x.com
端点路径/1.1/statuses/home_timeline.json/2/users/:id/timelines/reverse_chronological
必填参数user_id或screen_name将用户 id 设为路径参数 :id
认证OAuth 1.0a 用户上下文OAuth 1.0a 用户上下文

OAuth 2.0 授权码流程（PKCE）
请求速率限制/流量限制每 15 分钟可发出 15 次请求（OAuth 1.0a 用户上下文）

请求上限：24 小时内可达 100,000。		每 15 分钟内可发起 180 次请求

Post 配额上限:

使用 Essential 访问级别时为 500,000

在使用 Elevated 访问权限时为 200 万

使用 Academic Research 访问权限时为 1000 万
每个响应的默认 Post 数15100
每次响应的 Post 数上限800此端点将返回时间线中过去 7 天内创建的所有 Post，以及不受创建日期限制的最新 800 条。
提供 Post 编辑记录✔✔
可用的历史 Post最新的 800 条 Post（包括转发）最近的 3,200 条 Post（包括转推）
时间轴导航选项自从_用于更新轮询的 id（不包含该 id）

max_id（含在内）		start_time

结束_时间

since_id（不包含端点本身）用于更新轮询

until_id（不含端点）
用于细化结果的可选参数count

exclude_replies

include_rts

trim_user

tweet_mode

since_id

max_id		max_results

exclude（转推，回复）

tweet.fields

user.fields

place.fields

media.fields

poll.fields

expansions

start_time

end_time

since_id

until_id
支持发起与接收注解不适用如果在 tweet.fields 中包含注解，系统会根据 Post 文本为结果添加推断的注解数据，例如’音乐类型’和’民谣’或’音乐人’和’多莉·帕顿’
支持请求并接收特定的 Post指标不适用如果包含注释，则tweet.fields，结果将标注为“公开”_每条 Post 的度量，包括retweet_count，reply_count，quote_count和like_count,non_public_metrics，包括impression_count，user_profile_clicks,url_link_clicks。

其他媒体指标，例如观看次数_计数与视频播放度量。

更多有机_指标与推广_在具备 User Context 时可用于推广 Post 的指标。
支持发起和接收conversation_id无返回会话_id 字段，其值表示某个回复线程中最早发布的 Post，便于你跟踪会话。
Post JSON 格式标准 v1.1 数据格式X API v2format（由 fields 和 expansions 请求参数确定，与 v1.1 的格式不向后兼容）

要了解如何从 Standard v1.1 格式迁移到 X API v2 格式，请访问我们的数据格式迁移指南。
结果排序按时间倒序按时间逆序
结果分页不适用，必须通过 Post ID 导航可以使用分页在结果中前后翻阅_令牌
需要使用来自以下来源的凭证开发者应用与…相关项目✔

​
用户 Post 时间线

下表比较了标准 v1.1 与 X API v2 的用户 Post 时间线端点：
描述标准版 v1.1X API v2
文档API 参考文档API 参考文档
支持的 HTTP 方法GETGET
主机域https://api.x.comhttps://api.x.com
端点路径/1.1/statuses/user_timeline.json/2/users/:id/tweets
必填参数用户_id 或屏幕_名称将用户 ID 设为路径参数 :id
认证OAuth 1.0a 用户上下文

OAuth 2.0 仅应用模式		OAuth 1.0a 用户上下文

OAuth 2.0 仅应用

OAuth 2.0 Authorization Code with PKCE
请求频率限制/调用量限制每 15 分钟在 OAuth 1.0a 用户上下文中可发起 900 次请求

使用 OAuth 2.0 应用专用模式：每 15 分钟 1500 次请求

请求上限：24 小时内为 100,000。		每 15 分钟窗口内可发起 900 次请求（使用 OAuth 1.0a 用户上下文）

使用 OAuth 2.0 仅限应用模式，每个 15 分钟窗口内最多 1500 次请求

Post 限额：
使用 Essential 访问时为 500,000
使用 Elevated 访问时为 200 万
使用 Academic Research 访问权限时为 1000 万
每次响应的默认 Post 数量1510
每次响应的最大全部Post数量200100
可用的历史 Post最新的 3,200 条 Post（包括转推）最新的 3,200 条 Post（包括转发）
时间轴导航选项自从_since_id（不包含）用于更新轮询

最大值_id（包含端点）		开始_时间

结束_时间

自从_用于更新轮询的 id（不包含自身）

直至_id（不包含）
用于细化结果的可选参数计数
排除_回复
包含_转推数
裁剪_用户
Tweet_模式
自从_id
最大值_id		最大值_结果
exclude(retweets,replies)
tweet.fields
user.fields
place.fields
media.fields
poll.fields
expansions
开始_时间
结束_时间
自从_id
直到_id
支持发起与接收注解不适用返回包含基于 Post 文本推断的标注数据的 Post 结果，例如’音乐类型’和’民谣’或’音乐人’与’多莉·帕顿’
支持请求并接收特定 Post度量无返回包含可用公开字段的 Post 结果_每条 Post 的指标（包括转发）_计数，回复_计数，引用_计数与点赞_计数。

适用于 OAuth 1.0a 用户上下文：
其他非_公共_指标（包括展示）_计数, 用户_个人资料_点击次数, URL_链接_点击次数。

其他媒体指标，例如观看次数_计数与视频播放指标。

额外自然流量_指标与推广_使用 OAuth 1.0a 用户上下文可获取的推广 Post 指标。
支持发起与接收conversation_id无返回一个会话_id 字段，其值表示回复线程中首个发布的 Post，便于你跟踪会话。
Post JSON 格式标准 v1.1 数据格式X API v2格式（由 fields 和 expansions 请求参数确定，与 v1.1 的格式不向后兼容）

要了解如何从 Standard v1.1 格式迁移到 X API v2 格式，请访问我们的数据格式迁移指南。
结果排序按时间倒序按时间逆序
结果分页处理不适用；必须按 Post 的 id 进行导航可以使用分页来前后翻阅结果_令牌
需要使用与 Project 关联的 Developer App 凭据开发者应用与某个…相关项目✔
提供 Post 编辑记录✔✔
 

​
用户提及时间线

下表比较了标准 v1.1 与 X API v2 的用户提及时间线端点
描述Standard v1.1X API v2
文档API 参考API 参考
支持的 HTTP 方法GETGET
主机域名https://api.x.comhttps://api.x.com
端点路径/1.1/statuses/mentions_timeline.json/2/users/:id/mentions
必需参数无必需参数将用户 ID 设为路径参数 :id
认证OAuth 1.0a 用户上下文OAuth 1.0a 用户上下文

OAuth 2.0 App-Only

OAuth 2.0 授权码（PKCE）
默认请求速率限制使用 OAuth 1.0a 用户上下文：每 15 分钟 75 次请求

24 小时内上限 100,000 次请求。		使用 OAuth 1.0a 用户上下文：每 15 分钟窗口 180 次请求

使用 OAuth 2.0 App-Only：每 15 分钟窗口 450 次请求

Post 上限：

Essential 访问：500,000
Elevated 访问：200 万
Academic Research 访问：1,000 万
每个响应的默认 Post 数量1510
每个响应的最大 Post 数量200100
可用历史 Post最近的 800 条 Post最近的 800 条 Post
时间线导航选项since_id（不包含）用于增量轮询

max_id（包含）		start_time

end_time

since_id（不包含）用于增量轮询

until_id（不包含）
结果优化的可选参数count
trim_user
include_entities
tweet_mode
since_id
max_id		max_results
tweet.fields
user.fields
place.fields
media.fields
poll.fields
expansions
start_time
end_time
since_id
until_id
支持请求并接收annotations不适用返回基于 Post 文本推断的标注数据的 Post 结果，例如“Music Genre”“Folk Music”，或“Musician”“Dolly Parton”
支持请求并接收特定 Postmetrics不适用返回包含每条 Post 可用的 public_metrics（包括 retweet_count、reply_count、quote_count 和 like_count）的 Post 结果。

适用于 OAuth 1.0a 用户上下文：
附加的 non_public_metrics，包括 impression_count、user_profile_clicks、url_link_clicks。

附加的媒体指标，如 view_count 和视频播放指标。

对于推广的 Post，在 OAuth 1.0a 用户上下文下可获得附加的 organic_metrics 和 promoted_metrics
支持请求并接收conversation_id不适用返回一个 conversation_id 字段，其值表示回复线程中最先发布的 Post，帮助你跟踪会话。
Post JSON 格式Standard v1.1 数据格式X API v2 格式（由 fields 和 expansions 请求参数决定，与 v1.1 格式不向后兼容）

要了解如何从 Standard v1.1 格式迁移到 X API v2 格式，请参阅我们的数据格式迁移指南。
结果顺序按时间倒序按时间倒序
分页的请求参数不适用，必须通过 Post ID 导航可使用 pagination_token 向前或向后查看结果
需要使用与Project 关联的开发者应用的凭证✔
提供 Post 编辑历史✔✔
其他迁移资源 Post 查找：从 Standard v1.1 迁移到 X API v2 X API 迁移中心