Threads 公开数据 API

传入必填的 query 关键词或短语，查找匹配的 Threads 公开帖子。响应包含 status、request_id 与 data.results；先遍历 data.results，再进入 node.thread，遍历 thread_items 并读取每个 post。已观察到的字段包括字符串 pk 和 id、短代码 code、user.username、可用时的 caption.text、以 Unix 秒表示的 taken_at 以及 like_count。一个外层搜索结果可能包含多条帖子，计数或导出前应遍历并展开全部 thread_items。 请结合正文与作者资料判断相关性，不要把关键词命中直接当成已核实的品牌提及。结果可能随请求变化，也不覆盖所有匹配帖子。响应可能包含 data.cursor，但本接口只接受 query，不支持传入 cursor、page、日期范围或排序参数。去重、定时轮询、告警与情感分类均需在自己的应用中实现。

传入必填的 Threads username，获取该账号当前可用的公开帖子。这里需要账号用户名，而不是显示名称或数字账号 ID。响应包含 status、request_id 与 data.posts；先遍历 data.posts，再遍历 node.thread_items 并读取每个 post。已观察到同一串文包含多个条目，应全部展开。帖子字段包括字符串 pk 和 id、code、user.username、可用时的 caption.text、以 Unix 秒表示的 taken_at 与 like_count。集合中的 id 可能带账号后缀，请完整保留，不要强制转换成数字。 返回内容是可用样本，不是完整发帖历史。即使响应包含 data.cursor，请求也只接受 username，不支持 cursor、page、limit、日期范围或排序参数。比较多次账号内容观察时，应记录采集时间并按标识去重。内容的可见性与可用性可能变化，缺失指标应继续保留为未知。

使用 code 或 url 查询一篇 Threads 公开帖子，至少提供一种定位方式。code 是帖子短代码，不是数字帖子 ID；url 必须是 threads.com 或 threads.net 上的 HTTPS 帖子链接。两者同时提供时以 url 为准。将完整链接作为查询参数传入时，请进行 URL 编码。 响应包含 status、request_id 与 data.post，帖子字段包括字符串 id、code、username、text、以 Unix 秒表示的 taken_at、url，以及 like_count、reply_count、repost_count、quote_count 和 view_count。已观察到同一帖子的短代码查询结果与账号帖子集合中的作者、正文和发布时间一致。实测 view_count 明确为 null，表示浏览量不可用，不能转换为零。互动计数是查询时的观察值，不是私有分析数据；回复数与引用数不包含对应内容明细。仅支持公开且可用的帖子，输入无效或内容不可用时可能查询失败。

在必填的 query 中提供姓名、用户名或账号搜索关键词。响应包含 status、request_id 与 data.results，候选资料位于 data.results[].node。已观察到的字段包括 username、字符串 pk 和 id、full_name、is_verified、follower_count 与 profile_pic_url。查询完整资料或账号帖子前，应先核实并选定目标 username；显示名称相似并不能证明是同一个人或账号。 实测一个不存在的随机用户名返回成功响应与 data.results:[]。空数组表示该查询没有匹配结果，不代表服务故障，也不能单独证明某个账号已被删除。结果不是完整账号目录，接口没有开放分页参数。

传入必填的 Threads username 查询公开用户资料。响应包含 status、request_id 与 data.user。已观察到的字段包括字符串 pk 和 id、username、full_name、is_verified、follower_count、biography 与 profile_pic_url。公开用户名 zuck 的示例对应 Mark Zuckerberg，pk 与 id 均为 63055343223。账号标识应按字符串保存，粉丝数则是可能随查询时间变化的观察值。 实测一个不存在的用户名返回 status:ok 与 data.user:null。这应作为资料不可用的一次观察记录，而不是账号已删除的证明。本接口不返回粉丝身份、私密活动或受众人口统计。需要可选公开外链时，使用带简介链接的资料查询；需要账号内容时，使用账号帖子接口。

传入必填的 Threads username，获取包含可选简介链接信息的公开资料。响应包含 status、request_id 与 data.user。已观察到的字段包括字符串 pk 和 id、username、full_name、is_verified、follower_count、biography、profile_pic_url 与 bio_links。实测 zuck 的资料返回预期账号身份及空 bio_links 数组；这个结果没有验证非空链接条目的字段结构。 简介链接属于可选数据，空数组是有效结果，不意味着应猜测网站或联系地址。若有返回链接，请按原值保留，使用前核对目标地址。公开链接不构成联系许可，也不证明存在邮箱或拥有该目标网站。本接口不开放私密资料活动；公开粉丝数也不等于粉丝名单。