X(Twitter)
X(Twitter) · 225 个端点
- 创建 X 长文草稿创建长文草稿。
- 按文章 id 发布草稿长文发布长文。
- 创建书签文件夹创建书签文件夹。
- 向直播发送聊天消息向直播发送聊天消息
- 安排直播创建定时直播。
- 按 id 删除定时直播删除定时直播。
- 按 id 查询定时直播获取定时直播。
- 按 ID 开始已排期的直播开始已排期的直播
- 列出已排期的直播列出已排期的直播
- 按 ID 更新已排期的直播更新已排期的直播
- 按 id 查询聊天会话获取 Chat 会话。
- 按 id 列出聊天会话中的事件获取 Chat 会话事件。
- 列出你的聊天会话获取 Chat 会话列表。
- 创建群聊会话创建 Chat 群聊会话。
- 初始化聊天群组初始化聊天群组
- 将成员添加到群聊会话将成员添加到 Chat 群聊会话。
- 按 id 下载聊天媒体文件下载聊天媒体。
聊天媒体上传
- 追加聊天媒体上传内容追加聊天媒体上传。
- 完成聊天媒体上传完成聊天媒体上传。
- 初始化聊天媒体上传初始化聊天媒体上传。
- 删除会话中的聊天消息删除聊天消息。
- 向会话发送聊天消息发送聊天消息
社区详情
- 按 URL 获取 X(Twitter)社区详情按 URL 获取某个 Twitter/X 社区的详情。
- 按 id 查询 Community按 ID 获取 Community。
- 按 URL 获取 X(Twitter)社区帖子按 URL 获取某个 Twitter/X 社区内发布的帖子。
- 按关键词搜索社群搜索社群
- 撰写 Community Note创建 Community Note。
- 按 id 删除 Community Note删除 Community Note。
- 符合社区笔记条件的帖子搜索符合条件的帖子
- 评估 Community Note评估 Community Note。
- 你撰写过的社区笔记搜索你撰写的社区笔记
- 发起群组私信会话创建私信会话。
- 按事件 id 删除私信事件删除私信事件。
- 按事件 id 查询私信事件按 ID 获取私信事件。
私信记录
- 列出你的私信事件获取私信事件。
- 按会话 id 获取私信历史按会话 ID 获取私信事件。
- 按参与者 id 获取与某用户的私信历史按参与者 ID 获取私信事件。
- 下载私信中的媒体下载私信媒体。
发送私信
- 按会话 id 发送私信按会话 ID 创建私信。
- 按参与者 id 向用户发送私信按参与者 ID 创建私信消息。
- 创建 List创建 List。
- 按 list id 删除 List删除 List。
- 按 list id 查询 List按 ID 获取 List。
列表关注
- 关注 List关注 List。
- 按列表 ID 取消关注列表取消关注列表
- 按 list id 获取 List 的关注者获取 List 关注者。
- 将成员添加到 List添加 List 成员。
- 按用户 ID 从列表移除成员移除列表成员
- 按 list id 获取 List 成员获取 List 成员。
列表置顶
- 置顶列表置顶列表
- 按列表 ID 取消置顶列表取消置顶列表
- 按 list id 获取 List 时间线中的推文获取 List 帖子。
- 按列表 ID 更新列表更新列表
- 按 media key 获取媒体分析数据获取媒体分析数据。
媒体信息
- 按 media key 查询单个媒体项按 media key 获取媒体。
- 按 media key 查询媒体按 media keys 获取媒体。
- 为已上传媒体创建元数据创建媒体元数据。
- 为已上传媒体添加字幕创建媒体字幕。
- 删除已上传媒体的字幕删除媒体字幕。
媒体上传
- 按 id 追加媒体上传内容追加媒体上传。
- 按 id 完成媒体上传完成媒体上传。
- 初始化媒体上传初始化媒体上传
- 上传媒体文件上传媒体
- 按媒体 id 检查媒体上传状态获取媒体上传状态。
- 按 id 查询新闻故事按 ID 获取新闻故事。
- 按帖子 id 获取推文分析数据获取帖子分析数据。
- 收藏推文创建用户书签。
- 按帖子 id 移除书签删除书签。
帖子回复
- X / Twitter 帖子回复按 URL 将任意 X(Twitter)帖子的回复获取为结构化记录:作者、正文与互动数据。空结果是有效结果,并不表示目标帖子是否存在。
- 按推文 id 获取 X(Twitter)帖子评论获取按推文 ID 指定的 X(Twitter)帖子的最新评论,支持游标分页。
- 按推文 id 获取 X(Twitter)最新帖子评论Twitter:获取最新帖子评论(web)。
- 按推文 id 获取 X(Twitter)帖子评论Twitter:获取帖子评论(web)。
- X(Twitter)帖子的回复单条 X(Twitter)帖子的回复,每条回复一行:id、作者、作者名称、正文、时间、点赞、回复、转推、浏览量、链接,按 X 自己的顺序(最相关优先)。`tweet` 是帖子 URL(https://x.com/NASA/status/2095890075447964086)或其 id。`limit` 最多 100;X 每页约返回 9-12 条回复,一次运行最多读取 8 页。`session` 为必填:你的 `auth_token` 与 `ct0` Cookie,通过 Crawl4AI Session 扩展复制;仅用于本次运行且不会被存储。每页一次抓取;session 错误会消耗一个额度单位。列:id、author、author_name、text、posted_at、likes、replies、reposts、views、url。
- x.post.comments — routed: best of 3 providers, own keys firstReplies to an X (Twitter) post by tweet id — provider-native rows in `comments`
- x.post.comments — routed: best of 3 providers, own keys firstReplies to an X (Twitter) post by tweet id — provider-native rows in `comments`
推文计数
- 统计匹配查询的推文数 — 完整档案获取帖子计数(全量)。
- 统计匹配查询的推文数 — 近 7 天获取帖子计数(近期)。
- 向你自己的 X 账号发布推文向你自己的 X 账号发布帖子
- 按帖子 id 删除推文删除帖子。
帖子详情
- 按推文 id 获取 X(Twitter)帖子详情Twitter:获取推文详情(web)。
- 按 URL 获取 X(Twitter)帖子详情X(原 Twitter)— 帖子。
- 按 URL 获取 X(Twitter)推文 — 作者、互动数据按 URL 获取某条推文的详细信息,包含作者资料与互动指标。
- 按帖子 id 查询推文按 ID 获取帖子。
- 按帖子 id 列表查询推文按 ID 列表获取帖子。
点赞帖子
- 点赞帖子点赞帖子
- 按帖子 ID 取消点赞取消点赞帖子
- 按帖子 id 获取点赞用户获取帖子点赞用户。
- 按帖子 id 获取其引用推文获取帖子引用的帖子。
- 按帖子 ID 回复推文或继续你的话题串回复 X 帖子,或继续你自己的话题串
- 按帖子 ID 隐藏对你推文的回复隐藏回复
转发帖子
- 转发推文转发帖子
- 按帖子 ID 撤销转发撤销转发帖子
转发用户
- 按推文 id 获取 X(Twitter)转发用户Twitter:获取转推用户列表(web)。
- 按帖子 id 获取转发用户获取转发该帖子的用户。
- 按帖子 id 获取转发获取帖子转发。
- 流式获取符合筛选规则的推文流式获取筛选后的帖子
过滤流规则
- 列出过滤流规则获取过滤流规则。
- 添加或删除筛选流规则更新流规则
- 按 URL 获取 X(Twitter)视频推文转写使用 AI 转写从某条 Twitter 视频推文中提取转写文本。
- 按关键词搜索新闻搜索新闻
搜索帖子
- X / Twitter 搜索使用完整的高级搜索语法(from:、since:、until:、min_faves: 等操作符可直接写在查询中)搜索 X(Twitter),返回结构化推文,包含正文、作者、互动数据与游标分页。limit 为单页上限;原生一页约 20 条推文,除非 requireSinglePage 选择批量通道。
- 按关键词搜索 X(Twitter)— top、latest、media、people按关键词在 top、latest、media、people 或列表结果模式下搜索 X(Twitter),支持游标分页。
- 按关键词搜索 X(Twitter)帖子Twitter:获取搜索时间线(web)。
- 在 X(Twitter)上搜索帖子X(Twitter)针对一次搜索返回的帖子,每条帖子一行,按 X 的顺序:id、链接、正文、时间、作者、计数、浏览量、语言、媒体,以及是否为回复、引用或转推。`query` 是 X 搜索文本(rust lang、from:nasa since:2026-10-01);`mode` 为 latest 或 top;`limit` 最多 100。`session` 是你的 X 登录(`auth_token` 与 `ct0`,来自 Crawl4AI Session 扩展),仅用于本次运行。不提供时,仅支持在 latest 模式下使用 from:<account>(允许 since:/until:):即该账号的时间线,最新优先;更早的日期通过较慢的第二来源获取。其他查询会被拒绝且不计费。列:id、url、text、created、author、author_name、likes、reposts、replies、quotes、views、language、media、is_reply、is_quote、is_repost。
- x.search.posts — routed: best of 3 providers, own keys firstSearch X (Twitter) posts by keyword — provider-native rows in `posts`
- x.search.posts — routed: best of 3 providers, own keys firstSearch X (Twitter) posts by keyword — provider-native rows in `posts`
- 按关键词查询完整推文存档搜索全部帖子
- 按关键词搜索近 7 天的推文搜索近期帖子
- 按关键词搜索 Spaces搜索 Spaces
- 按关键词搜索用户搜索用户
- 按用户 id 列表获取创作者主持的 Space按创作者 ID 获取 Space。
Space 详情
- 按 space id 查询 Space按 ID 获取 Space。
- 按 space id 列表查询 Space按 ID 列表获取 Space。
- 按 space id 获取 Space 中分享的推文获取 Space 帖子。
- 按 space id 获取 Space 购票者获取 Space 购票者。
- 已连接用户的个性化热门话题获取个性化热门话题。
热门话题
- 按国家获取 X(Twitter)热门话题Twitter:获取热门话题(web)。
- 按位置 WOEID 获取热门话题按 WOEID 获取热门话题。
- 按用户 id 获取其关联账号获取用户关联账号。
- 按用户 id 获取其屏蔽的账号获取用户屏蔽列表。
- 按用户 id 获取你的书签文件夹获取用户书签文件夹。
书签
- 按用户 id 获取你收藏的推文获取用户书签。
- 按文件夹 id 获取其中的书签推文按文件夹 ID 获取用户书签。
私信屏蔽
- 按用户 id 屏蔽其私信屏蔽用户私信。
- 按用户 ID 解除对该用户私信的屏蔽解除用户私信屏蔽
关注用户
- 按用户 id 关注用户关注用户。
- 按用户 ID 取消关注用户取消关注用户
- 某用户关注的列表(按用户 ID)获取用户关注的列表
用户粉丝
- 按用户名获取 X(Twitter)用户粉丝Twitter:获取用户粉丝(web)。
- 某用户的粉丝(按用户 ID)获取用户的粉丝
关注账号
- 按用户名获取 X(Twitter)用户关注账号Twitter:获取用户关注(web)。
- 某用户关注的账号(按用户 ID)获取用户关注的账号
- 某用户点赞过的推文(按用户 ID)获取用户点赞过的帖子
- 某用户加入的列表(按用户 ID)获取用户的列表成员关系
- 按用户名获取 X(Twitter)用户媒体帖子Twitter:获取用户媒体(web)。
- 提及某用户的推文(按用户 ID)获取用户的提及
静音用户
- 按用户 ID 静音用户静音用户
- 按用户 ID 取消静音取消静音用户
- 某用户静音的账号(按用户 ID)获取用户静音的账号
- 某用户拥有的列表(按用户 ID)获取用户拥有的列表
- 某用户置顶的列表(按用户 ID)获取用户置顶的列表
用户帖子
- X / Twitter 用户推文与回复获取某个 X(Twitter)账号发布的推文与回复,最多达到请求的 limit,包含互动数据、浏览量、语言,并在可用时支持游标分页。
- X / Twitter 用户帖子按用户名获取某个 X(Twitter)账号资料页「帖子」标签的时间线。结果遵循资料页顺序:置顶帖子可能排在最前,其余为按时间倒序排列的原创帖子、转推、引用与自发推文串续篇。
- X(Twitter)账号的帖子某个 X(Twitter)账号的最新帖子,每条帖子一行:id、链接、正文、点赞、转推、回复、引用、时间、是否为转推以及作者。`username` 是用户名(nasa 或 @nasa)、资料页 URL 或 X 的数字用户 id(11348282)。`limit` 最多 100;X 每页约返回 15-20 条帖子,一次运行最多读取两页。`session` 是你自己的 X 登录(`auth_token` 与 `ct0` Cookie,来自 Crawl4AI Session 扩展)(可选),仅用于本次运行,永不存储。不提供时,本次运行以访客身份读取 X;当 X 对访客不返回内容时,由较慢的第二来源作答。列:id、url、text、likes、retweets、replies、quotes、created、is_retweet、author。
- 按数字用户 id 获取 X(Twitter)用户帖子获取按 Rest ID 指定的 X(Twitter)用户发布的帖子,支持游标分页。
- 按用户名获取 X(Twitter)用户推文按用户名获取某个 Twitter 用户资料页中的推文。
- 按用户名或用户 id 获取 X(Twitter)用户帖子X(Twitter)用户的近期帖子。
- 某用户近期的推文(按用户 ID)— 互动指标列出 X 用户(你自己或任意公开账号)近期的帖子
- x.user.posts — routed: best of 5 providers, own keys firstList an X (Twitter) user's recent posts — provider-native post objects in `posts`
- x.user.posts — routed: best of 5 providers, own keys firstList an X (Twitter) user's recent posts — provider-native post objects in `posts`
用户资料
- Twitter 资料按用户名获取某个 Twitter/X 账号的公开资料(粉丝数、推文数、简介、认证信息)。
- 按 URL 获取 X(Twitter)资料X(原 Twitter)— 资料。
- X(Twitter)资料将一个 X(Twitter)账号表示为一行:用户名、名称、简介、粉丝数、关注数、推文数、加入日期、所在地、网站、认证标识、头像与用户 id。`username` 是用户名(nasa 或 @nasa)或资料页 URL。`session` 是你自己的 X 登录(`auth_token` 与 `ct0` Cookie,来自 Crawl4AI Session 扩展),可选,仅用于本次运行且永不存储。不提供时,本次运行以访客身份读取 X;当 X 不返回任何内容时,由较慢的第二来源作答。列:username、name、bio、followers、following、tweets、created、location、website、verified、image、user_id。
- 按数字用户 id 获取 X(Twitter)用户资料获取按数字 Rest ID 指定的 X(Twitter)用户资料。
- 按用户名获取 X(Twitter)资料 — 账号统计按用户名获取某个 Twitter 用户的资料,包含账号元数据与统计数据。
- 按用户名或用户 id 获取 X(Twitter)资料按用户名或数字 id 获取公开 X(Twitter)资料。
- 你已连接的 X 账号资料 — 用户名、粉丝获取已连接 X 账号的资料(用户名、名称、粉丝数)
- 按用户名查询 X 用户资料 — 粉丝、简介、认证按用户名获取任意公开 X 用户的资料
- x.user.profile — routed: best of 5 providers, own keys firstGet an X (Twitter) user's public profile — treg picks the provider and names the one that served
- x.user.profile — routed: best of 5 providers, own keys firstGet an X (Twitter) user's public profile — treg picks the provider and names the one that served
- 按用户 ID 查询用户按 ID 获取用户
- 按用户 ID 批量查询用户按 ID 批量获取用户
- 按用户名查询用户按用户名获取用户
- 按用户名获取 X(Twitter)用户回复Twitter:获取用户推文回复(web)。
- 你的推文被转发的情况获取你推文的转发
- 主页时间线推文,最新在前(按用户 ID)获取用户时间线
账号与工具类端点
- 添加加密公钥添加公钥。
- 为聊天会话添加加密密钥添加会话密钥。
- 按 Webhook ID 检查账号活动订阅验证账号活动订阅
- 统计你的 Account Activity 订阅数量获取 Account Activity 订阅数量。
- 统计你的过滤流规则数量获取规则计数。
- 创建合规任务创建合规任务。
- 创建 Webhook 重放任务为 Webhook 创建重放任务。
- 创建活动订阅创建 X 活动订阅。
- 按 Webhook id 删除过滤流关联删除流关联。
- 按 Webhook id 删除 Webhook删除 Webhook。
- 按订阅 id 列表删除活动订阅按 ID 删除 X 活动订阅。
- 按订阅 id 删除活动订阅删除 X 活动订阅。
- 某用户的加密公钥(按用户 ID)获取公钥
- 英文推文的全量流流式获取英文帖子
- 日文推文的全量流流式获取日文帖子
- 韩文推文的全量流流式获取韩文帖子
- 葡萄牙文推文的全量流流式获取葡萄牙文帖子
- 全部点赞的全量流流式获取全部点赞
- 全部推文的全量流流式获取全部帖子
- 流式连接历史获取连接历史。
- 按 Webhook id 将其关联到过滤流创建流关联。
- 按 Webhook id 列出 Account Activity 订阅获取 Account Activity 订阅。
- 按类型列出合规任务获取合规任务。
- 列出筛选流 Webhook 链接获取流链接
- 列出你的活动订阅获取 X 活动订阅。
- 列出你注册的 Webhook获取 Webhook
- 按 id 查询合规任务按 ID 获取合规任务。
- 按用户 ID 批量查询加密公钥获取公钥
- 将聊天会话标记为已读将会话标记为已读
- X API 的 OpenAPI 规范获取 OpenAPI 规范。
- 注册 Webhook创建 Webhook。
- 移除用户的 Account Activity 订阅删除订阅。
- 向聊天会话发送正在输入状态发送输入状态
- 流式获取点赞合规事件流式获取点赞合规数据
- 流式获取帖子合规事件流式获取帖子合规数据
- 流式获取用户合规事件流式获取用户合规数据
- 流式获取 10% 抽样点赞流式获取抽样点赞
- 流式获取 10% 抽样推文流式获取 10% 抽样帖子
- 实时流式接收活动事件活动流。
- 实时流式获取抽样推文流式获取抽样帖子
- 流式获取推文标签事件流式获取帖子标签
- 将 Webhook 订阅到 Account Activity 事件创建订阅。
- 终止所有流式连接终止所有连接。
- 按端点 id 终止流式连接按端点终止连接。
- 按 uuid 终止流式连接终止多个连接。
- 推文用量对比套餐上限获取用量。
- Twitter 社区按 URL 获取某个 Twitter/X 社区的公开详情(名称、简介、成员数、加入策略)。
- Twitter 社区帖子按 URL 列出某个 Twitter/X 社区中近期发布的帖子。
- Twitter 推文按 URL 获取单条 Twitter/X 推文,包含完整正文与互动计数(点赞、转推、回复、引用、书签、浏览量)。
- Twitter 推文转写按 URL 从 Twitter/X 视频推文中提取语音转写文本。
- 按订阅 ID 更新活动订阅更新 X 活动订阅
- 按 Webhook ID 验证 Webhook验证 Webhook
- X / Twitter 长文通过长文的外层帖子 URL 获取公开的 X 长文,包含作者、互动数据、封面图与结构化内容块。
- X / Twitter 社区搜索按关键词搜索 X(Twitter)社区,返回其 id、名称、主题与成员数,支持游标分页。可用此方式找到社区 URL,再传给 twitter.community 或 twitter.community_tweets。
- X / Twitter 粉丝按用户名获取任意公开 X(Twitter)账号的粉丝列表,支持游标分页。limit 为单页上限,原生一页最多 200 个账号;继续获取时跟随响应中的 nextCursor。
- X / Twitter 关注列表按用户名列出某个公开 X(Twitter)账号关注的账号,支持游标分页。limit 为单页上限,原生一页最多 200 个账号;继续获取时跟随响应中的 nextCursor。
- X / Twitter 热门话题按 X 的排行顺序获取全球、某个国家或某个城市当前 X(Twitter)热门话题,包含解析后的位置。
- X / Twitter 推文串解析包含某条 X(Twitter)帖子的线性自发推文串,从根帖一直到作者链接的后续内容。不包含其他用户的回复。
- X / Twitter 用户搜索按关键词搜索 X(Twitter)账号 — 即 X 搜索的 People 标签页。匹配用户名、显示名称与个人简介,返回规范化的资料记录以及粉丝、关注与帖子数,支持游标分页。搜索帖子请使用 twitter.search。
这些端点可以调用,但不在目录的浏览面上。