Threads
Threads Post API
获取 Threads 帖子详情及附带的作者、媒体和评论等数据。
接口说明
Threads Post API 获取 Threads 帖子详情及附带的作者、媒体和评论等数据。
使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。
请求URL
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
采集最长约75秒,客户端超时建议设为90秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| target | Yes | string | 帖子链接(支持短链,不支持直接传 id) |
仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。
附带评论限一页;需要继续获取评论时调用对应评论接口。
响应值
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 返回数据,结构见下表 |
| meta | object | 请求标识及耗时(毫秒) |
| billing | object | 计费条数、单价及规则版本 |
返回参数 data 说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | Type 可用值: [“post”] |
| poster | object | 作者 |
| post | object | Post |
| comments | object[] | 页面内联的回复, 一次性返回, 没有分页; 条数少于 commentsCount 说明未取全 |
data.poster 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| username | string | null | 用户名 |
| fullName | string | null | 显示名 |
| avatar | string | null | 头像 |
| profileUrl | string | null | 主页链接 |
| isVerified | boolean | 是否认证 |
| pk | string | number | null | 用户数字 id |
data.post 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | string | 帖子 shortcode |
| postUrl | string | null | 帖子链接 |
| captionText | string | null | 正文 |
| hashtags | string[] | 正文话题 (含 #) |
| mentions | string[] | 正文提及 (含 @) |
| media | object[] | 媒体列表 (轮播全部展开) |
| publishedAt | object | null | 发布时间 (text 为 ISO) |
| likes | number | null | 点赞数 |
| commentsCount | number | null | 直接回复数 |
| repostsCount | number | null | 转发数 |
| sharesCount | number | null | 分享数; 匿名常为 null |
| quotesCount | number | null | 引用数 |
| views | number | null | 浏览数 |
| pk | string | number | null | 帖子数字主键 |
| isReply | boolean | 本身是否一条回复 |
| replyTo | string | null | 被回复的用户名 (isReply 时) |
| accessibilityCaption | string | null | 无障碍描述 |
| linkPreview | object | null | 外链预览卡片; 没有为 null |
| links | string[] | 正文外链 |
data.post.media[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | 媒体类型 可用值: [“image”, “video”] |
| imageUrl | string | null | 图片 / 视频封面链接 |
| videoUrl | string | null | 视频链接 (图片为 null) |
| width | number | null | 宽 (px) |
| height | number | null | 高 (px) |
| accessibilityCaption | string | null | 无障碍描述 (平台自动生成或作者填写) |
data.post.publishedAt 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| text | string | null | 上游原始时间文本 |
| value | number | null | 解析后的毫秒时间戳; 解析失败为 null |
data.post.linkPreview 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| url | string | null | 链接 |
| displayUrl | string | null | 显示用的短域名 |
| title | string | null | 卡片标题 |
| imageUrl | string | null | 卡片图片 |
data.comments[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | string | 回复帖子 shortcode |
| avatar | string | null | 回复者头像 |
| username | string | null | 回复者用户名 |
| fullName | string | null | 回复者显示名 |
| profileUrl | string | null | 回复者主页 |
| content | string | null | 回复内容 |
| time | object | null | 回复时间 (text 为 ISO) |
| likes | number | null | 点赞数 |
| replyCount | number | 该回复下的二级回复数 (内容不展开) |
| replyTo | string | null | 被回复的用户名 |
| isAuthorReply | boolean | 是否主帖作者的回复 |
| pk | string | number | null | 回复数字主键 |
| commentUrl | string | null | 回复链接 |
| authorPk | string | number | null | 回复者数字 id |
| isVerified | boolean | 回复者是否认证 |
| hashtags | string[] | 正文话题 (含 #) |
| mentions | string[] | 正文提及 (含 @) |
| media | object[] | 回复附带的媒体 |
| links | string[] | 正文外链 |
data.comments[].time 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| text | string | null | 上游原始时间文本 |
| value | number | null | 解析后的毫秒时间戳; 解析失败为 null |
data.comments[].media[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | 媒体类型 可用值: [“image”, “video”] |
| imageUrl | string | null | 图片 / 视频封面链接 |
| videoUrl | string | null | 视频链接 (图片为 null) |
| width | number | null | 宽 (px) |
| height | number | null | 高 (px) |
| accessibilityCaption | string | null | 无障碍描述 (平台自动生成或作者填写) |
请求示例
返回示例
下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。
积点消耗说明
每条帖子、视频或商家主体消耗 0.8 积点,附带评论、回复和作者资料免费。
空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

