跳转到主要内容
下表展示了 v2 端点与各类认证方法的对应关系。
终端节点OAuth 1.0a 用户上下文OAuth 2.0 仅限应用 
OAuth 2.0
带 PKCE 的授权码模式
Post 查找

通过一组 id 获取多个 Tweet

GET /2/tweets

通过 id 获取单条 Tweet

GET /2/tweets/:id


作用域:

tweet.read

users.read
管理 Tweet

发布一条 Tweet

POST /2/tweets

删除一条 Tweet

DELETE /2/tweets/:id


作用域:

tweet.read

tweet.write

users.read
时间线

用户 Tweet 时间轴

GET /2/users/:id/tweets

用户提及时间轴

GET /2/users/:id/mentions

按时间倒序的主页时间线

GET /2/users/:id/timelines/reverse_chronological




作用域:

tweet.read

users.read



作用域:

tweet.read

users.read
近期搜索

搜索过去 7 天内发布的 Tweet

GET /2/tweets/search/recent


作用域:

tweet.read

users.read
全量档案搜索

仅对拥有“Academic Research”访问权限的用户开放

搜索完整的 Tweet 全量存档

GET /2/tweets/search/all
过滤后的流

在你的流中添加或删除规则

POST /2/tweets/search/stream/rules

获取你的流’的规则

GET /2/tweets/search/stream/rules

连接到数据流

GET /2/tweets/search/stream
批量流

实时流式获取全量 Tweet 的约 1%。

GET /2/tweets/sample/stream
管理转发

转发一条 Tweet

POST /2/users/:id/retweets

删除一次转推

DELETE /2/users/:id/retweets/:source_tweet_id


作用域:

tweet.read

tweet.write

users.read
转推查询

转推过该 Tweet 的用户

GET /2/tweets/:id/retweeted_by


作用域:

tweet.read

users.read
书签查询

获取已加书签的 Tweet

GET /2/tweets/:id/bookmarks


权限:

tweet.read

users.read

bookmark.read
管理书签

将 Tweet 设为书签

POST /2/tweets/:id/bookmarks

移除 Tweet 书签

DELETE /2/users/:id/bookmarks:tweet_id


作用域:

tweet.read

users.read

bookmark.write
管理“赞”

点赞一条 Tweet

POST /2/users/:id/likes

取消对 Tweet 的喜欢

DELETE /2/users/:id/likes/:tweet_id


权限:

tweet.read

users.read

like.write
点赞查找

点赞该条 Tweet 的用户

GET /2/tweets/:id/liking_users

用户赞过的 Tweet

GET /2/users/:id/liked_tweets


作用域:

tweet.read

users.read

like.read
隐藏回复

隐藏或取消隐藏对 Tweet 的回复。

PUT /2/tweets/:id/hidden


权限范围:

tweet.read

users.read

tweet.moderate.write
用户查找

通过多个 id 获取多个用户

GET /2/users

通过 id 获取单个用户

GET /2/users/:id

通过用户名获取多个用户

GET /2/users/by

通过用户名检索单个用户

GET /2/users/by/username/:username

获取已认证用户的信息

GET /2/users/me


作用域:

tweet.read

users.read
管理关注关系

允许某个用户 ID 关注另一位用户

POST /2/users/:id/following

允许通过用户 id 取消关注另一位用户

DELETE /2/users/:source_user_id/following/:target_user_id


作用域:

tweet.read

users.read

follows.write
关注查询

根据id查询某用户的关注列表

GET /2/users/:id/following

通过 id 查找某用户的关注者

GET /2/users/:id/followers


作用域:

tweet.read

users.read

follows.read
封锁查询

返回被指定用户 ID 屏蔽的用户列表

GET /2/users/:id/blocking


权限:

tweet.read

users.read

block.read
管理屏蔽

允许某个用户的 id 将另一位用户设为静音

POST /2/users/:id/muting

允许通过用户 id 取消对另一位用户的静音

DELETE /2/users/:source_user_id/muting/:target_user_id


权限:

tweet.read

users.read

mute.write
静音查询

返回由指定用户ID静音的用户列表

GET /2/users/:id/muting


作用域:

tweet.read

users.read

mute.read
Spaces 查询

通过 id 查找 Space

GET /2/spaces/:id

查询多个 Space

GET /2/spaces

按用户 id 发现其创建的 Spaces

GET /2/spaces/by/creator_ids


作用域:

tweet.read

users.read

space.read
Spaces 查询

获取已为某个 Space 购票的用户

GET /2/spaces/:id/buyers


作用域:

tweet.read

users.read

space.read
Space 搜索

返回与您指定搜索词匹配的实时或已安排的 Spaces。

GET /2/spaces/search


作用域:

tweet.read

users.read

space.read
列表查找

通过 id 查找特定列表

GET /2/lists/:id

查找某个用户’拥有的列表

GET /2/users/:id/owned_lists


作用域:

tweet.read

users.read

list.read
列表管理

为已通过身份验证的用户创建新的列表

POST /2/lists


作用域:

tweet.read

users.read

list.read

list.write
管理清单

删除经身份验证用户所拥有的列表

DELETE /2/lists/:id

更新已认证用户所拥有的列表的元数据

PUT /2/lists/:id


权限:

tweet.read

users.read

list.write
列表 Tweet 查找

从指定的 List 查找 Tweets

GET /2/lists/:id/tweets


作用域:

tweet.read

users.read

list.read
列表成员查找

返回指定列表的成员清单

GET /2/lists/:id/members

返回指定用户所属的所有列表

GET /2/users/:id/list_memberships


作用域:

tweet.read

users.read

list.read
管理列表成员

将成员添加到已认证用户拥有的列表

POST /2/lists/:id/members

将成员从身份验证用户所拥有的列表中移除

DELETE /2/lists/:id/members/:user_id


权限:

tweet.read

users.read

list.write
列表关注查找

返回指定列表的所有粉丝

GET /2/lists/:id/followers

返回指定用户所关注的全部列表

GET /2/users/:id/followed_lists


权限:

tweet.read

users.read

list.read
管理列表关注者

代表已认证用户关注某个列表

POST /2/users/:id/followed_lists

代表已认证用户取消关注某个列表

DELETE /2/users/:id/followed_lists/:list_id


作用域:

tweet.read

users.read

list.write
固定列表查找

返回已登录用户已置顶的列表

GET /2/users/:id/pinned_lists


作用域:

tweet.read

users.read

list.read
管理置顶的 List

代表已认证用户固定一个列表

POST /2/users/:id/pinned_lists

代表已验证用户取消固定某个列表

DELETE /2/users/:id/pinned_lists/:list_id


作用域:

tweet.read

users.read

list.write
批量合规性

创建新的合规任务

POST /2/compliance/jobs

返回指定合规模块的状态和下载信息

GET /2/compliance/jobs/:job_id

返回最近的合规任务列表

GET /2/compliance/jobs