跳转到主要内容
通过异步任务 API 以 JSON 读取公开的 Threads 数据。发送 taskType SOCIAL 并设置 platform threads,用 action 选择要读取的内容。每次完成的请求消耗 0.5 积分。

请求

提交任务后,轮询 GET /v1/async/task/{id} 或通过 webhook 接收。参见异步任务。

操作

username 接受用户名或个人主页 URL。postUrl 接受帖子 URL,例如 https://www.threads.com/@natgeo/post/Dfzi22JJSYp。

参数

  • query:search 必填。
  • limit:可选。search 和 profile 范围 1-50,默认 10。replies 范围 1-500,默认 50。

响应示例

结果字段

  • 每个响应都会原样返回 platform 和 action。列表带有 returnedCount。
  • 帖子包含 id、code、url、text、author、authorVerified、publishedAt、mediaType(text、image、video 或 carousel)、images、videoUrl、likeCount、replyCount、repostCount、quoteCount、shareCount 和 isReply。回复还会加上 replyTo,即被回复的用户名。
  • search 按 Threads 显示的顺序返回 posts,最多约 50 条。
  • profile 返回 id、username、displayName、biography、bioLinks、avatarUrl、profileUrl、isVerified、isPrivate、followerCount、threadCount 和 recentPosts,即个人主页显示的最新 4-13 条帖子。
  • post 返回 post。replies 返回 replies,每条帖子约 10 条。availableCount 是帖子的回复数,partial: true 表示列表短于该数量,例如作者隐藏了回复。
  • 不存在或未公开的个人主页或帖子会使任务以 PAGE_UNAVAILABLE 结束。只对完成的请求计费。

相关