Threads User Reposts
Threads 用户转发是一个账号主动转给自己粉丝的帖子,每一条都是原帖本身,带有原作者、正文、图片视频、发布时间,以及它积累的点赞、回复和转发数。转发是有意为之的认可,这份清单能看出一个账号在替谁发声、品牌在力推哪些合作方,以及哪些内容在一个圈子里流传开来。
Threads User Reposts API 主要特性
- 每次转发背后的原帖每一行都是被转发的那条帖子,author 是它的原作者,账号到底转了谁的内容一目了然。
- 原帖的互动数据metrics.likes_count、metrics.comments_count 和 metrics.shares_count 是原帖的点赞、回复和转发数,能看出被转发的内容原本有多少热度。
- 用主页链接取最近转发urls 接受 https://www.threads.com/@shams 这样的主页链接,每个主页返回最近转发的帖子,最多约 25 条。
Threads User Reposts API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | Threads 主页链接,格式为 /@{username},threads.com 和 threads.net 均可,例如 https://www.threads.com/@shams。 |
如何使用 Threads User Reposts API
提交主页链接,读取它转发过的帖子。
- 向 /v1/threads/user-reposts 发送 {"urls": ["https://www.threads.com/@shams"]},保存 task_id。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 读取被转发的帖子;has_more 为 true 时,沿着 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@shams"]}'
# 0.5 credits per reposted post returned.Threads User Reposts API 最佳使用场景
- 梳理账号在替谁扩散内容: 统计一个主页转发记录里各个 author.username 出现的次数,排出它最常转发的创作者和媒体。
- 看出品牌在推哪些合作方: 查看品牌转发内容的原作者和正文,找出它选择助推的合作者、品牌大使和媒体。
- 追踪在圈子里流传的内容: 采集同一领域一批账号的转发,找出被其中多个账号共同转发的帖子 id。
Threads User Reposts API 使用建议
- 需要知道每条转发出自哪个账号时,一个任务只提交一个主页,因为每一行的 author 都是原作者。
- published_at 是原帖的发布时间;想知道转发出现的时间,就定期采集,记录每个 id 第一次出现的时刻。
- 想看某条被转发帖子下面的讨论,把它的 url 交给 Threads Post Replies API。
相关 API
除了 Threads User Reposts API,需要其他类型的 Threads 公开数据时,可以使用以下 API。
- Threads Posts API — 从受支持的 Threads 帖子 URL 采集公开正文、作者信息、媒体、时间和可见互动指标。
- Threads Profiles API — 从受支持的 Threads 主页 URL 采集公开身份、简介、图片、网站、可见账号数量和采集上下文。
- Threads User Posts API — 通过 Threads 主页 URL 和每个主页的结果上限发现公开帖子,返回标准化正文、作者、媒体、时间、可见互动指标和来源上下文。
- Threads Post Replies API — 通过帖子 URL 采集 Threads 帖子下的回复,返回回复正文、作者、点赞数和回复数、图片视频,以及所回复帖子的 ID。
- Threads Search API — 按关键词或话题标签搜索 Threads 热门帖子,返回正文、作者、点赞数、回复数、转发数、图片视频和发布时间。
- Threads User Replies API — 通过 Threads 主页 URL 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。