X（Twitter）公开数据 API

传必填 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 按字符串保存，计数另记采集时间；认证标签不等于身份核验。

必填 rest_ids 是逗号分隔的数字账号 ID 字符串，不是 JSON 数组。接口描述为返回对应用户资料数组，但具体字段、最大批量和不可用账号行为尚未实测验证。以返回标识关联输入，不能假定响应顺序或每个 ID 都有一条记录；单用户名查询可用已有 active/notfound 示例的 user-info。

传必填 screenname，请求公开账号可用的注册及使用背景，作为普通简介与计数的补充。具体元数据键、历史深度和未命中行为尚未实测验证。缺失背景应保留为空，不推断事件，不用背景信息证明位置、身份或账号控制权。

必填 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 去重，游标缺失、为空或重复时停止，不承诺完整历史或流式推送。

传必填 screenname，可选 rest_id 和 cursor；ID 选择行为尚未独立验证。已观察到 status=ok、timeline、user、next_cursor，记录含推文 ID、正文、时间、计数、作者和媒体；照片位于 media.photo，带 media_url_https 与 id。结构随帖子变化，按同一账号游标续页，保留来源推文 ID；链接不代表转载许可，也不是私密内容或完整媒体库入口。

必填 screenname 选择回复作者，cursor 用于同一账号的可用续页。这与按推文 id 查收到回复的 latest-replies 不同。具体回复字段、返回游标键和账号不可用形态尚未实测验证；记录只表示观察到的公开对话活动，不是完整互动历史或私信。

必填 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 去重，保留查询与采集时间；它不是指定账号时间线或内置情绪分析。

必填 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 可为数字字符串。计数会变化，不是后台曝光；不可用推文行为尚未验证。

必填 id 选择收到回复的公开原帖，cursor 继续该帖可用回复页。它不同于按用户名查主动回复的 user-replies。回复字段、输出游标、严格时间排序和不可用推文行为尚未实测验证；可访问讨论只是有界样本，不是全部回复或推送流。

必填 id 请求公开推文的基础信息及可用回复，可选 cursor 继续支持的讨论页。原帖上下文与回复记录应分开存储；接口并未建立完整还原作者连续推文串的保证。字段、输出分页与缺失原帖行为尚未实测验证，严格解析前须确认结构，导出时标明限制和遗漏。

必填 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 去重并记时间，不假定最新粉丝顺序或完整名单。

传必填 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 去重，记录采集时间，缺失行不能证明取关。

必填 id 指定公开推文，可选 cursor 使用同帖上一页返回的 next_cursor。该续页字段有文档描述，但整体响应、账号字段与不可用推文行为尚未实测验证。返回者是采集到的转发样本，不代表完整传播图，也不能推断点赞者或引用帖作者。

必填 user 为源账号，follows 为目标账号。近期关系检查对大账号及较早关注有限制；接受的标识格式和精确结果字段尚未实测验证。先用已知公开关系确认结构，阳性可作辅助证据，阴性不证明没有关注。接口不新增或取消关注。

传必填 tweet_id 与 screenname，尽力查询近期转发，较早活动可能不覆盖。精确状态或布尔键、账号或原帖缺失行为尚未实测验证。先核对已知公开案例，不以阴性排除旧转发或认定未参与；这是读取，不发起转发，也不衡量全部互动。

必填 screenname 选择企业 X 账号，cursor 继续可用关联集合。关联表示平台显示的联系，不是法律所有权、雇佣关系或完整组织结构。资料字段、分页输出和空集合行为尚未实测验证；先验证标识和覆盖，再补全账号资料或时间线。

必填 list_id 为已知公开 List 的字符串 ID，cursor 请求同一列表的可用续页。内容关联列表精选成员，不是个性化首页。推文字段、返回分页键和私密或不可用列表行为尚未实测验证；保留列表 ID 与采集时间，核对推文标识，不假定全部成员活动或完整历史。

必填 list_id，请求公开 List 中被加入的账号，可选 cursor 续页。成员不同于订阅者，后者使用 list-followers。成员资料、分页输出和不可用列表行为尚未实测验证。先核对返回标识再补全目录；跨快照比较必须保留日期及覆盖范围。

必填 list_id，cursor 请求同一公开 List 的可用订阅者续页。订阅者与被收录的 list-members 成员不同。返回字段、续页键以及缺失或私密列表行为尚未实测验证；导出的是注明日期的可见覆盖，不是完整订阅普查或兴趣证明。

必填 query，可选 cursor 继续同关键词的候选社区。社区发现与社区帖子搜索不同，后者有最新和热门专用接口。具体 ID、描述字段、排序和无匹配形态尚未实测验证。先人工复核相关性、确认标识，再请求 community-info、community-members 或 community-posts。

必填 community_id 为已知 X Community 的字符串标识。请求可用描述资料，不保证成员普查或全部帖子。具体键、字段完整度及不可用社区状态尚未实测验证；公开字段级示例前先核对真实结果，区分群组不可用与现有群组的属性缺失。

必填 community_id，可选 ranking 单选 Top 或 Latest，可选 cursor 继续同群组同模式。帖子字段、实际排序、返回分页键和不可用群组形态尚未实测验证。收集的是观察到的社区讨论样本，不是完整归档或内置主题分析。

必填 community_id，可选 cursor 继续同群组成员页。成员标识、资料属性、分页字段及不可用社区行为尚未实测验证；去重或资料补全前核对返回结构。可见成员是观察到的覆盖，不是完整参与普查，也不透露私人兴趣或人口属性。

必填 query，可选 cursor 继续同词结果，不需要 community_id。它是跨社区的最新导向搜索，不是一个群组全部帖子。具体帖子与社区上下文、游标输出、无匹配行为和严格时间覆盖尚未实测验证。去重或变化跟踪前核对 ID 与时间，定时轮询不等于实时流。

必填 query，可选 cursor 继续同词热门结果。Top 是本接口排序，不能当作全平台热度或已知互动公式。帖子、社区背景、续页键与无匹配行为尚未实测验证；比较返回样本时保留关键词及采集时间。

必填 country，但接受值及格式尚未实测验证，不能直接套用 inspiration-posts 的三字母国家选项。趋势字段、排序、话题量及不支持国家行为仍须确认。保留请求值和采集时间，可将观察到的词作为帖子搜索候选，不能据此证明作者所在地。

country、period、type 均必填，分别单选文档值。国家包含 ALL 及列出的三字母代码，周期为 Daily/Weekly/Monthly，类型为 Likes/Replies。不要把选项清单作为逗号字符串发送。选择行为、结果字段和排名语义尚未实测验证；适合注明来源的创作研究，不是通用表现基准或素材使用许可。

必填 rest_id 为字符串数字账号 ID，不能传 screenname；需要时先用 user-info 解析用户名。状态键、直播标识、未直播形态和延迟尚未实测验证。展示前确认结构，定时检查需去抖；观察到的变化是轮询证据，不是推送，不提供视频流或启动直播。

必填 id 来自已知公开 Spaces 链接，可含字母数字，不是数字推文或账号 ID。接口描述为基础信息，具体键、生命周期与不可用 Space 行为尚未实测验证。确认响应后再展示，不承诺音频流、录音、转写、听众身份或完整出席历史。

必填 query 为职位关键词，文档示例为 developer，未声明地区、薪资、日期或分页输入。职位字段、标识、来源引用与无匹配形态尚未实测验证。仅在实际返回稳定 ID 或链接且已验证时去重；结果是可见职位样本，不覆盖整个招聘市场，也不提交求职申请。