按用户名获取 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 功能

用户名直达账号内容 使用一个已确认的 username 获取该账号可用的公开内容,无需先转换为数字账号标识。
保留串文中的所有条目 遍历 data.posts,再遍历 node.thread_items 并读取每个 post,保留同一串文内返回的多条帖子,避免只读取第一条。
完整保存账号帖原始标识 分别以字符串保存 pk、可能带复合后缀的 id 与短代码 code,供后续去重及单帖详情查询使用。
内容观察附带作者与时间 将 user.username、caption.text 和 taken_at 与自己的采集时间一起记录,说明当时观察到了哪个账号的哪些内容。

在线 API 演示

GET /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。可在应用中对返回样本进行日期筛选或排序,但不能据此认定未返回的帖子不可用,也不能假设样本覆盖完整。

相关接口

相关指南

查看订阅方案 →