跳转到主要内容
这三个时间线端点支持已编辑的 Post。这些端点始终会返回最新的编辑版本以及完整的编辑历史。任何在其 30 分钟编辑窗口结束后收集的 Post 都将表示其最终版本。编辑元数据包含一个数组,包含其历史中所有 Post 的 id。对于没有编辑历史的 Post,此数组仅包含一个 id。对于已被编辑的 Post,此数组包含多个 id,按升序排列以反映编辑顺序,数组最后一个元素为最新版本。要了解 Post 编辑的工作方式,请参阅编辑 Post 基础页面。

按时间倒序的首页时间线

此端点可让你检索经过认证的用户及其所关注账号最近发布的 Post、转发(Retweet)和回复。 由于你是在代表用户发出请求,必须使用 OAuth 2.0 Authorization Code Flow with PKCEOAuth 1.0a User Context 对这些端点进行认证。此端点对每位用户的频率限制为每 15 分钟 180 次请求。此端点可返回时间线在过去 7 天内创建的每条 Post,以及不论创建日期的最近 800 条。

用户 Post 时间线

用户 Post 时间线端点可访问特定 X 账号已发布的 Post。检索某个用户的 Post,可用于构建在用户界面中展示时间线、分析其 Post 以更好地理解其内容,或以编程方式基于其 Post 创建互动工作流等体验。此端点可让你访问单个 X 账号的最新 Post、转发(Retweets)、回复以及引用转发(Quote Tweets),类似于用户个人资料时间线中所见的内容。 以下是 @XDevelopers 的用户时间线: 用户 Post 时间线端点是一个 REST 端点,它接收单一路径参数以指示目标用户(通过用户 ID)。该端点可返回该用户最近的 3,200 条 Post、转发、回复和引用转发。 Post 按时间倒序返回,从最新开始。结果分页,每页最多 100 条 Post。提供分页令牌以便在大量 Post 中分页浏览。给定页面中包含的最新与最旧 Post 的 Post ID 也会作为元数据提供,也可用于轮询时间线以获取最新的 Post。用户 Post 时间线还支持指定 start_time 和 end_time 参数,以接收在特定时间窗口内创建的 Post。 用户 Post 时间线端点支持 fieldsexpansions 参数,并返回新的 JSON data 格式 要成功向此端点发起请求,你需要使用 OAuth 1.0a User ContextOAuth 2.0 Authorization Code with PKCEOAuth 2.0 App-Only 认证方式为请求授权。当请求非公开指标、推广指标或受保护用户的时间线时,必须使用 OAuth 1.0a User Context 或 OAuth 2.0 Authorization Code with PKCE。 用户 Post 时间线端点旨在支持两种常见使用模式:
  • “获取用户的历史 Post”:对用户 Post 时间线发起请求,在特定的近期时间范围内按时间顺序接收目标用户创作的 Post。可使用 start_time 和 end_time 设置时间范围,并分页遍历完整结果。在某些情况下,如果该用户账号仅创作了不超过 3,200 条 Post,则可检索其完整的 Post 历史。包含的 Post 将取决于其公开可用性以及请求所用的认证方式。
  • “轮询新 Post”:持续地对用户 Post 时间线发起请求,以检索特定用户新创作的 Post。可将上次接收的最后一个 Post ID 作为参数,用于自上次 Post 以来的任何新请求。

用户提及时间线

用户提及时间线端点允许你请求包含对特定 X 用户的提及的 Post。例如,如果某个 X 账号在一条 Post 中提到了 @XDevelopers。该端点还会包含对所请求用户的 Post 的回复。获取用户的“被提及”可用于构建体验,例如快速发现谁在回复某位用户的 Post、谁在提及 TA,或以编程方式为其 Post 创建互动流程。该端点允许你请求某个用户最新的提及与回复,类似于在 X 上用户的提及通知中所见的内容。 用户提及时间线是一个 REST 端点,它接收一个路径参数来标识目标用户(通过用户 ID)。该端点最多可返回该用户最近的 800 条提及。 Post 按时间倒序返回,从最新开始。结果会分页,每页最多 100 条 Post。提供分页令牌以便在大规模 Post 集合中翻页。还会提供该页面中最新与最旧 Post 的 Post ID 作为元数据,可用于轮询时间线以获取最新 Post,或类似 v1.1 mentions_timeline 端点那样在时间线中导航。该端点还支持指定 start_time 和 end_time 参数,以接收在特定时间窗口内创建的 Post。 要成功调用此端点,你需要使用 OAuth 1.0a 用户上下文OAuth 2.0 授权码(PKCE)OAuth 2.0 App-Only 认证方法为请求授权。当请求非公开指标、推广指标或受保护用户的时间线时,必须使用 OAuth 1.0a 用户上下文或 OAuth 2.0 授权码(PKCE)。 用户提及时间线端点支持 fieldsexpansions 参数,并返回新的 JSON data 格式
账户设置要访问这些端点,你需要:在我们的入门指南中了解如何获取对 X API v2 端点的访问权限。
支持性资源 了解如何使用 Postman 发起请求 排查错误 访问此端点的 API 参考页面