按用户名获取 Threads 可用帖子集合
查看 Threads 公开数据 API 的全部接口 →传入必填的 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、日期范围或排序参数。比较多次账号内容观察时,应记录采集时间并按标识去重。内容的可见性与可用性可能变化,缺失指标应继续保留为未知。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/threads-scraper/list-user-posts API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/threads-scraper/list-user-posts?key=<API_KEY>&username=zuck'
查询结果
使用场景
- 创作者关注清单摘要:查询选定用户名的可用帖子,在自己的应用中整理注明作者与来源的内容摘要。
- 竞品表达方式对比:比较已知账号返回样本中的主题与措辞,不将样本当作完整发帖历史。
- 账号内容研究语料:保存正文、原始字符串标识与采集时间,并使用一致的帖子键合并重复观察。
- 筛选单帖详情目标:从账号帖子中提取短代码,选出需要进一步查询正文与互动计数的具体帖子。
常见问题
data.posts 中的每个条目都只代表一篇帖子吗?
不是。每个条目内有 node.thread_items,里面可能包含多篇帖子。制作摘要、统计帖子数或导出记录前,应遍历 data.posts,再遍历 node.thread_items 并读取每个 post。
能获取该账号的全部发帖历史吗?
本接口获取按用户名查询时当前可用的公开集合,不保证完整历史。即使返回 data.cursor,也没有开放分页输入。不要添加 cursor、page 或其他未文档化参数。
为什么帖子集合中的 ID 可能和单帖详情中的 ID 不一样?
已观察到集合中的 id 带有帖子与账号组合后缀,而 pk 是看起来像数字的帖子标识,code 是短代码。所有值都应按字符串原样保存。调用单帖详情时使用 code,不要假设所有标识字段都可以互换。
能按日期筛选账号帖子,或强制按最新排序吗?
接口没有定义日期、排序或数量上限输入,唯一参数是 username。可在应用中对返回样本进行日期筛选或排序,但不能据此认定未返回的帖子不可用,也不能假设样本覆盖完整。