跳转到主要内容
下表展示了各 v2 endpoint 与其所用身份验证方法的对应关系。
EndpointOAuth 1.0a 用户上下文OAuth 2.0 App only
OAuth 2.0
授权码与 PKCE
Tweet 查找

通过 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_cronological




作用域:

tweet.read

users.read



作用域:

tweet.read

users.read
最近搜索

搜索过去 7 天内发布的 Tweet

GET /2/tweets/search/recent


作用域:

tweet.read

users.read
全档案搜索

仅对拥有学术研究访问权限的用户可用

搜索 Tweet 的完整档案

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

为您的流添加或删除规则

POST /2/tweets/search/stream/rules

检索您的流规则

GET /2/tweets/search/stream/rules

连接到流

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

实时流式传输约 1% 的所有 Tweet。

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

查询多个 Spaces

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
Spaces 搜索

返回与您指定的搜索词匹配的直播或预定的 Spaces

GET /2/spaces/search


作用域:

tweet.read

users.read

space.read
List 查询

通过 ID 查询特定 List

GET /2/lists/:id

查询用户拥有的 List

GET /2/users/:id/owned_lists


作用域:

tweet.read

users.read

list.read
管理 List

代表已认证用户创建新的 List

POST /2/lists


作用域:

tweet.read

users.read

list.read

list.write
管理 List

删除已认证用户拥有的 List

DELETE /2/lists/:id

更新已认证用户拥有的 List 的元数据

PUT /2/lists/:id


作用域:

tweet.read

users.read

list.write
List Tweet 查询

从指定 List 查询 Tweet

GET /2/lists/:id/tweets


作用域:

tweet.read

users.read

list.read
List 成员查询

从指定 List 返回成员列表

GET /2/lists/:id/members

返回指定用户作为成员的所有 List

GET /2/users/:id/list_memberships


作用域:

tweet.read

users.read

list.read
管理 List 成员

向已认证用户拥有的 List 添加成员

POST /2/lists/:id/members

从已认证用户拥有的 List 中移除成员

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


作用域:

tweet.read

users.read

list.write
List 关注查询

返回指定 List 的所有关注者

GET /2/lists/:id/followers

返回指定用户关注的所有 List

GET /2/users/:id/followed_lists


作用域:

tweet.read

users.read

list.read
管理 List 关注

代表已认证用户关注 List

POST /2/users/:id/followed_lists

代表已认证用户取消关注 List

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


作用域:

tweet.read

users.read

list.write
置顶 List 查询

返回已认证用户的置顶 List

GET /2/users/:id/pinned_lists


作用域:

tweet.read

users.read

list.read
管理固定的 List

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

POST /2/users/:id/pinned_lists

代表已认证用户取消固定一个 List

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
I