X(Twitter)公开数据 API — 打开交互式演示
引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
/api/project/twitter/user-info 按用户名获取 X 公开用户资料
说明
传必填 screenname,不带 @,查询公开账号资料。可选 rest_id 优先选择账号,但仍须传 screenname。已观察到命中 status=active,字段含 profile、rest_id、id、name、desc、website、avatar、header_image、location、created_at、protected、blue_verified 和 verification_type;sub_count 为粉丝数,friends 为关注数,另有 statuses_count 与 media_count。不存在用户名返回 notfound,身份与计数为 null。ID 按字符串保存,计数另记采集时间;认证标签不等于身份核验。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/profiles-by-rest-ids 按多个账号 ID 批量查询公开资料
说明
必填 rest_ids 是逗号分隔的数字账号 ID 字符串,不是 JSON 数组。接口描述为返回对应用户资料数组,但具体字段、最大批量和不可用账号行为尚未实测验证。以返回标识关联输入,不能假定响应顺序或每个 ID 都有一条记录;单用户名查询可用已有 active/notfound 示例的 user-info。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/about-profile 获取账号注册与使用背景
说明
传必填 screenname,请求公开账号可用的注册及使用背景,作为普通简介与计数的补充。具体元数据键、历史深度和未命中行为尚未实测验证。缺失背景应保留为空,不推断事件,不用背景信息证明位置、身份或账号控制权。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/user-timeline 分页获取指定账号的近期推文
说明
必填 screenname,可选 rest_id 优先选取账号但不会取消用户名要求。第一页省略 cursor,后续原样传 next_cursor。已观察到 status=ok、timeline、user、next_cursor、prev_cursor;推文有 tweet_id、text、created_at、favorites、retweets、replies、quotes、bookmarks、views、entities、author 和 media。转发可能含 retweeted、retweeted_tweet,作者可为空,views 可为数字字符串。核对 author.rest_id,按 tweet_id 去重,游标缺失、为空或重复时停止,不承诺完整历史或流式推送。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/users-media 分页读取账号公开媒体帖子
说明
传必填 screenname,可选 rest_id 和 cursor;ID 选择行为尚未独立验证。已观察到 status=ok、timeline、user、next_cursor,记录含推文 ID、正文、时间、计数、作者和媒体;照片位于 media.photo,带 media_url_https 与 id。结构随帖子变化,按同一账号游标续页,保留来源推文 ID;链接不代表转载许可,也不是私密内容或完整媒体库入口。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/user-replies 查询账号公开发出的回复
说明
必填 screenname 选择回复作者,cursor 用于同一账号的可用续页。这与按推文 id 查收到回复的 latest-replies 不同。具体回复字段、返回游标键和账号不可用形态尚未实测验证;记录只表示观察到的公开对话活动,不是完整互动历史或私信。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/search 搜索公开推文与话题标签
说明
必填 query,search_type 已验证 Latest,其他模式仍须确认。首请求不传 cursor,后续保持查询与模式不变回传 next_cursor。已观察到 status=ok、timeline、next_cursor、prev_cursor,记录有 tweet_id、正文、时间、计数、user_info 和 media,可含引用内容。NASA 也匹配过其他语言中使用 nasa 的无关作者,因此检查正文及 user_info.rest_id,按推文 ID 去重,保留查询与采集时间;它不是指定账号时间线或内置情绪分析。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/tweet-info 按推文 ID 获取详情与公开互动数
说明
必填 id 为公开推文的字符串 ID。已观察到 status=active、id、conversation_id、text、display_text、created_at、likes、retweets、replies、quotes、bookmarks、views、lang、sensitive、author、entities 和 media。作者可含 rest_id、screen_name、name、image、认证和 sub_count;回复上下文及 conversation_control.policy 可为空,views 可为数字字符串。计数会变化,不是后台曝光;不可用推文行为尚未验证。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/latest-replies 查询指定推文收到的近期回复
说明
必填 id 选择收到回复的公开原帖,cursor 继续该帖可用回复页。它不同于按用户名查主动回复的 user-replies。回复字段、输出游标、严格时间排序和不可用推文行为尚未实测验证;可访问讨论只是有界样本,不是全部回复或推送流。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/tweet-thread 查询推文基础上下文与可用回复
说明
必填 id 请求公开推文的基础信息及可用回复,可选 cursor 继续支持的讨论页。原帖上下文与回复记录应分开存储;接口并未建立完整还原作者连续推文串的保证。字段、输出分页与缺失原帖行为尚未实测验证,严格解析前须确认结构,导出时标明限制和遗漏。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/followers 分页读取公开账号的粉丝列表
说明
必填 screenname,可选 cursor,blue_verified 文档值为 0/1,过滤行为未验证。已观察到 status=ok、followers_count、followers、next_cursor、more_users。条目含 user_id、screen_name、name、profile_image、created_at、followers_count 和认证字段,其他简介、网站或计数可为空。总粉丝数不是本页条数;按字符串 user_id 去重并记时间,不假定最新粉丝顺序或完整名单。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/following 分页查询账号关注的用户
说明
传必填 screenname,可选 rest_id 与 cursor;ID 优先级未独立验证。已观察到 status=ok、following、next_cursor、more_users,条目包含 user_id、screen_name、name、description、profile_image、website、created_at 与账号计数。字段随记录变化,计数描述返回账号,不是目标的关系历史。按 user_id 去重,记录采集时间,缺失行不能证明取关。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/retweets 查询公开推文的转发参与账号
说明
必填 id 指定公开推文,可选 cursor 使用同帖上一页返回的 next_cursor。该续页字段有文档描述,但整体响应、账号字段与不可用推文行为尚未实测验证。返回者是采集到的转发样本,不代表完整传播图,也不能推断点赞者或引用帖作者。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/check-follow 尽力查询两个公开账号的关注关系
说明
必填 user 为源账号,follows 为目标账号。近期关系检查对大账号及较早关注有限制;接受的标识格式和精确结果字段尚未实测验证。先用已知公开关系确认结构,阳性可作辅助证据,阴性不证明没有关注。接口不新增或取消关注。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/check-retweet 检查账号近期是否转发指定推文
说明
传必填 tweet_id 与 screenname,尽力查询近期转发,较早活动可能不覆盖。精确状态或布尔键、账号或原帖缺失行为尚未实测验证。先核对已知公开案例,不以阴性排除旧转发或认定未参与;这是读取,不发起转发,也不衡量全部互动。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/affiliates 读取企业账号显示的关联账号
说明
必填 screenname 选择企业 X 账号,cursor 继续可用关联集合。关联表示平台显示的联系,不是法律所有权、雇佣关系或完整组织结构。资料字段、分页输出和空集合行为尚未实测验证;先验证标识和覆盖,再补全账号资料或时间线。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/list-timeline 读取公开 List 的推文流
说明
必填 list_id 为已知公开 List 的字符串 ID,cursor 请求同一列表的可用续页。内容关联列表精选成员,不是个性化首页。推文字段、返回分页键和私密或不可用列表行为尚未实测验证;保留列表 ID 与采集时间,核对推文标识,不假定全部成员活动或完整历史。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/list-members 获取公开 List 精选成员账号
说明
必填 list_id,请求公开 List 中被加入的账号,可选 cursor 续页。成员不同于订阅者,后者使用 list-followers。成员资料、分页输出和不可用列表行为尚未实测验证。先核对返回标识再补全目录;跨快照比较必须保留日期及覆盖范围。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/list-followers 查询公开 List 的订阅账号
说明
必填 list_id,cursor 请求同一公开 List 的可用订阅者续页。订阅者与被收录的 list-members 成员不同。返回字段、续页键以及缺失或私密列表行为尚未实测验证;导出的是注明日期的可见覆盖,不是完整订阅普查或兴趣证明。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/communities-search 按主题发现 X Community 社区
说明
必填 query,可选 cursor 继续同关键词的候选社区。社区发现与社区帖子搜索不同,后者有最新和热门专用接口。具体 ID、描述字段、排序和无匹配形态尚未实测验证。先人工复核相关性、确认标识,再请求 community-info、community-members 或 community-posts。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/community-info 读取已知公开社区的基础信息
说明
必填 community_id 为已知 X Community 的字符串标识。请求可用描述资料,不保证成员普查或全部帖子。具体键、字段完整度及不可用社区状态尚未实测验证;公开字段级示例前先核对真实结果,区分群组不可用与现有群组的属性缺失。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/community-posts 按社区读取热门或最新帖子
说明
必填 community_id,可选 ranking 单选 Top 或 Latest,可选 cursor 继续同群组同模式。帖子字段、实际排序、返回分页键和不可用群组形态尚未实测验证。收集的是观察到的社区讨论样本,不是完整归档或内置主题分析。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/community-members 分页请求公开社区的可用成员
说明
必填 community_id,可选 cursor 继续同群组成员页。成员标识、资料属性、分页字段及不可用社区行为尚未实测验证;去重或资料补全前核对返回结构。可见成员是观察到的覆盖,不是完整参与普查,也不透露私人兴趣或人口属性。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/communities-posts-search-latest 跨社区搜索近期关键词帖子
说明
必填 query,可选 cursor 继续同词结果,不需要 community_id。它是跨社区的最新导向搜索,不是一个群组全部帖子。具体帖子与社区上下文、游标输出、无匹配行为和严格时间覆盖尚未实测验证。去重或变化跟踪前核对 ID 与时间,定时轮询不等于实时流。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/communities-posts-search-top 跨社区搜索热门关键词帖子
说明
必填 query,可选 cursor 继续同词热门结果。Top 是本接口排序,不能当作全平台热度或已知互动公式。帖子、社区背景、续页键与无匹配行为尚未实测验证;比较返回样本时保留关键词及采集时间。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/twitter/trends 查询国家范围的可用趋势词
说明
必填 country,但接受值及格式尚未实测验证,不能直接套用 inspiration-posts 的三字母国家选项。趋势字段、排序、话题量及不支持国家行为仍须确认。保留请求值和采集时间,可将观察到的词作为帖子搜索候选,不能据此证明作者所在地。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/inspiration-posts 按国家、周期和互动类型查创作参考
说明
country、period、type 均必填,分别单选文档值。国家包含 ALL 及列出的三字母代码,周期为 Daily/Weekly/Monthly,类型为 Likes/Replies。不要把选项清单作为逗号字符串发送。选择行为、结果字段和排名语义尚未实测验证;适合注明来源的创作研究,不是通用表现基准或素材使用许可。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/twitter/user-live 按账号 ID 查询当前可用直播状态
说明
必填 rest_id 为字符串数字账号 ID,不能传 screenname;需要时先用 user-info 解析用户名。状态键、直播标识、未直播形态和延迟尚未实测验证。展示前确认结构,定时检查需去抖;观察到的变化是轮询证据,不是推送,不提供视频流或启动直播。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/spaces-info 查询公开 X Space 的基础信息
说明
必填 id 来自已知公开 Spaces 链接,可含字母数字,不是数字推文或账号 ID。接口描述为基础信息,具体键、生命周期与不可用 Space 行为尚未实测验证。确认响应后再展示,不承诺音频流、录音、转写、听众身份或完整出席历史。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/twitter/jobs-search 按关键词发现 X 公开招聘职位
说明
必填 query 为职位关键词,文档示例为 developer,未声明地区、薪资、日期或分页输入。职位字段、标识、来源引用与无匹配形态尚未实测验证。仅在实际返回稳定 ID 或链接且已验证时去重;结果是可见职位样本,不覆盖整个招聘市场,也不提交求职申请。
| 参数 | 位置 | 值 |
|---|---|---|
| query |