Threads
Threads Home API
获取 Threads 主页资料及首屏作品数据。
接口说明
Threads Home API 获取 Threads 主页资料及首屏作品数据。
使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。
请求URL
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
采集最长约75秒,客户端超时建议设为90秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| target | Yes | string | 主页链接; 也可直接传用户名 (可带 @) |
仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。
附带首屏作品;更多作品请使用对应作品接口(如提供)。
响应值
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 返回数据,结构见下表 |
| meta | object | 请求标识及耗时(毫秒) |
| billing | object | 计费条数、单价及规则版本 |
返回参数 data 说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | Type 可用值: [“home”] |
| profile | object | Profile |
| works | object[] | 主页首屏帖子 |
| pagination | object | 作品分页 |
data.profile 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| accountId | string | number | null | Threads 用户 id |
| userId | string | number | null | Threads 用户 id (同 accountId) |
| igUserId | string | number | null | 关联的 Instagram 用户 id |
| username | string | null | 用户名 |
| nickname | string | null | 显示名, 没有时用用户名 |
| fullName | string | null | 全名 |
| profileUrl | string | 主页链接 |
| avatar | string | null | 头像 (最大尺寸) |
| avatarThumb | string | null | 头像缩略图 |
| verified | boolean | 是否认证 |
| isVerified | boolean | 是否认证 (同 verified) |
| isPrivate | boolean | 是否私密账号 |
| followersCount | number | null | 粉丝数 |
| bio | string | null | 简介 |
| biography | string | null | 简介 (同 bio) |
| contactEmail | string | null | 从简介里提取的邮箱 |
| externalLinks | string[] | 简介外链 (bioLinks 的 url) |
| bioLinks | object[] | 简介外链详情 |
| profileTags | string[] | 主页标签 |
| hasOnboardedToTextPostApp | boolean | 是否已开通 Threads |
| showTextPostAppBadge | boolean | 是否显示 Threads 徽章 |
| targetUrl | string | 请求的链接 |
data.profile.bioLinks[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| url | string | null | 链接 |
| lynxUrl | string | null | Meta 跳转链接 |
| linkId | string | number | null | 链接 id |
| title | string | null | 链接标题 |
| isVerified | boolean | 是否已验证 |
data.works[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| workId | string | number | null | 帖子数字主键 |
| postId | string | number | null | 帖子数字主键 (同 workId) |
| code | string | 帖子 shortcode |
| workType | string | 作品类型: 视频 / 图片 / 纯文字 可用值: [“video”, “image”, “post”] |
| url | string | 帖子链接 |
| caption | string | null | 正文 |
| content | string | null | 正文 (同 caption) |
| takenAt | number | null | 发布时间毫秒时间戳 |
| publishedAt | number | null | 发布时间毫秒时间戳 (同 takenAt) |
| takenAtISO | string | null | 发布时间 ISO |
| likes | number | null | 点赞数 |
| likeCount | number | null | 点赞数 (同 likes) |
| replyCount | number | null | 回复数 |
| repostCount | number | null | 转发数 |
| quoteCount | number | null | 引用数 |
| isReply | boolean | 本身是否一条回复 |
| hasVideo | boolean | 是否有视频 |
| cover | string | null | 封面 (最大尺寸图片) |
| image | string | null | 图片 (同 cover) |
| imageWidth | number | null | 图片宽 |
| imageHeight | number | null | 图片高 |
| videoUrl | string | null | 视频链接 |
| accessibilityCaption | string | null | 无障碍描述 |
| audience | string | null | 可见范围 (上游原样, 公开帖通常为 null) |
| shareCount | number | null | 分享数 |
| media | object[] | 媒体列表 (轮播全部展开) |
| hashtags | string[] | 正文话题 (含 #) |
| mentions | string[] | 正文提及 (含 @) |
| links | string[] | 正文外链 |
| linkPreview | object | null | 外链预览卡片; 没有为 null |
data.works[].media[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | 媒体类型 可用值: [“image”, “video”] |
| imageUrl | string | null | 图片 / 视频封面链接 |
| videoUrl | string | null | 视频链接 (图片为 null) |
| width | number | null | 宽 (px) |
| height | number | null | 高 (px) |
| accessibilityCaption | string | null | 无障碍描述 (平台自动生成或作者填写) |
data.works[].linkPreview 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| url | string | null | 链接 |
| displayUrl | string | null | 显示用的短域名 |
| title | string | null | 卡片标题 |
| imageUrl | string | null | 卡片图片 |
data.pagination 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| endCursor | string | null | 上游下一页游标 (目前没有续取接口, 仅透出) |
| hasMore | boolean | 是否还有更多 |
请求示例
返回示例
下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。
积点消耗说明
每份主页资料消耗 0.8 积点,附带作品免费。
空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

