threads/
user-reposts

提交 Threads 主页链接,采集账号最近转发过的帖子,每条以原帖形式返回,含原作者、正文、点赞数、回复数、转发数和图片视频,每个账号最多约 25 条。

Threads User Reposts API

主页链接输入
每行都是原作者
最近约 25 条转发
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

提交主页链接,读取它转发过的帖子。

  1. 向 /v1/threads/user-reposts 发送 {"urls": ["https://www.threads.com/@shams"]},保存 task_id。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 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。

除了 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 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。

探索其他平台

还可以将 Threads 数据与其他已支持社交平台的公开数据结合使用。

Threads User Reposts API — 常见问题

Threads User Reposts API 是一个用于根据主页链接采集 Threads 账号所转发帖子的 API。它把每条转发作为原帖返回,包含原作者、正文、点赞数、回复数、转发数和图片视频。

author 始终是帖子的原作者。转发它的账号就是你提交的那个主页。

每个主页返回最近转发的帖子,最多约 25 条。

每返回一条帖子计 0.5 积分,一个有 25 条近期转发的主页计 12.5 积分。