接口说明

Threads Home API 获取 Threads 主页资料及首屏作品数据。

使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。

请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/threads-home

请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集最长约75秒,客户端超时建议设为90秒。

请求参数

参数必填类型说明
targetYesstring主页链接; 也可直接传用户名 (可带 @)

仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。

附带首屏作品;更多作品请使用对应作品接口(如提供)。

响应值

返回值类型说明
codeinteger状态码,0 表示成功
messagestring响应信息,成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据,结构见下表
metaobject请求标识及耗时(毫秒)
billingobject计费条数、单价及规则版本

返回参数 data 说明

返回值类型说明
typestringType
可用值: [“home”]
profileobjectProfile
worksobject[]主页首屏帖子
paginationobject作品分页

data.profile 字段说明

返回值类型说明
accountIdstring | number | nullThreads 用户 id
userIdstring | number | nullThreads 用户 id (同 accountId)
igUserIdstring | number | null关联的 Instagram 用户 id
usernamestring | null用户名
nicknamestring | null显示名, 没有时用用户名
fullNamestring | null全名
profileUrlstring主页链接
avatarstring | null头像 (最大尺寸)
avatarThumbstring | null头像缩略图
verifiedboolean是否认证
isVerifiedboolean是否认证 (同 verified)
isPrivateboolean是否私密账号
followersCountnumber | null粉丝数
biostring | null简介
biographystring | null简介 (同 bio)
contactEmailstring | null从简介里提取的邮箱
externalLinksstring[]简介外链 (bioLinks 的 url)
bioLinksobject[]简介外链详情
profileTagsstring[]主页标签
hasOnboardedToTextPostAppboolean是否已开通 Threads
showTextPostAppBadgeboolean是否显示 Threads 徽章
targetUrlstring请求的链接

data.profile.bioLinks[] 字段说明

返回值类型说明
urlstring | null链接
lynxUrlstring | nullMeta 跳转链接
linkIdstring | number | null链接 id
titlestring | null链接标题
isVerifiedboolean是否已验证

data.works[] 字段说明

返回值类型说明
workIdstring | number | null帖子数字主键
postIdstring | number | null帖子数字主键 (同 workId)
codestring帖子 shortcode
workTypestring作品类型: 视频 / 图片 / 纯文字
可用值: [“video”, “image”, “post”]
urlstring帖子链接
captionstring | null正文
contentstring | null正文 (同 caption)
takenAtnumber | null发布时间毫秒时间戳
publishedAtnumber | null发布时间毫秒时间戳 (同 takenAt)
takenAtISOstring | null发布时间 ISO
likesnumber | null点赞数
likeCountnumber | null点赞数 (同 likes)
replyCountnumber | null回复数
repostCountnumber | null转发数
quoteCountnumber | null引用数
isReplyboolean本身是否一条回复
hasVideoboolean是否有视频
coverstring | null封面 (最大尺寸图片)
imagestring | null图片 (同 cover)
imageWidthnumber | null图片宽
imageHeightnumber | null图片高
videoUrlstring | null视频链接
accessibilityCaptionstring | null无障碍描述
audiencestring | null可见范围 (上游原样, 公开帖通常为 null)
shareCountnumber | null分享数
mediaobject[]媒体列表 (轮播全部展开)
hashtagsstring[]正文话题 (含 #)
mentionsstring[]正文提及 (含 @)
linksstring[]正文外链
linkPreviewobject | null外链预览卡片; 没有为 null

data.works[].media[] 字段说明

返回值类型说明
typestring媒体类型
可用值: [“image”, “video”]
imageUrlstring | null图片 / 视频封面链接
videoUrlstring | null视频链接 (图片为 null)
widthnumber | null宽 (px)
heightnumber | null高 (px)
accessibilityCaptionstring | null无障碍描述 (平台自动生成或作者填写)

data.works[].linkPreview 字段说明

返回值类型说明
urlstring | null链接
displayUrlstring | null显示用的短域名
titlestring | null卡片标题
imageUrlstring | null卡片图片

data.pagination 字段说明

返回值类型说明
endCursorstring | null上游下一页游标 (目前没有续取接口, 仅透出)
hasMoreboolean是否还有更多

请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/threads-home \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.threads.com/@zuck"
}'

返回示例

下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 0.8,
  "data": {
    "type": "home",
    "profile": {
      "accountId": "63055343223",
      "userId": "63055343223",
      "igUserId": null,
      "username": "zuck",
      "nickname": "Mark Zuckerberg",
      "fullName": "Mark Zuckerberg",
      "profileUrl": "https://www.threads.com/@zuck",
      "avatar": "https://instagram.flas1-1.fna.fbcdn.net/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s640x640_tt6&efg=eyJ2ZW5jb2RlX3RhZyI...",
      "avatarThumb": "https://instagram.flas1-1.fna.fbcdn.net/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI...",
      "verified": true,
      "isVerified": true,
      "isPrivate": false,
      "followersCount": 5761360,
      "bio": "Mostly superintelligence and MMA takes",
      "biography": "Mostly superintelligence and MMA takes",
      "contactEmail": null,
      "externalLinks": [],
      "bioLinks": [],
      "profileTags": [
        "aithreads"
      ],
      "hasOnboardedToTextPostApp": true,
      "showTextPostAppBadge": true,
      "targetUrl": "https://www.threads.com/@zuck"
    },
    "works": [
      {
        "workId": "4023876994299759089",
        "postId": "4023876994299759089",
        "code": "DfXrs6RGonx",
        "workType": "post",
        "url": "https://www.threads.com/@zuck/post/DfXrs6RGonx",
        "caption": "Now in the Muse app: talk with your Muse in real time. And pick from multiple voices 🗣️",
        "content": "Now in the Muse app: talk with your Muse in real time. And pick from multiple voices 🗣️",
        "takenAt": 1793903539000,
        "publishedAt": 1793903539000,
        "takenAtISO": "2026-11-05T18:32:19.000Z",
        "likes": 1082,
        "likeCount": 1082,
        "replyCount": 460,
        "repostCount": 52,
        "quoteCount": 11,
        "isReply": false,
        "hasVideo": false,
        "cover": null,
        "image": null,
        "imageWidth": null,
        "imageHeight": null,
        "videoUrl": null,
        "accessibilityCaption": null,
        "audience": null,
        "shareCount": 40,
        "media": [],
        "hashtags": [],
        "mentions": [],
        "links": [],
        "linkPreview": null
      }
    ],
    "pagination": {
      "endCursor": "QVFEUG1fR1hHb1NSRFNZVTNFeWZtU1hXUHZabVJOQ3NyMjgtU1lWQUtwSWVuZ19GZ0ZMbFhTcWIxSEphb1Nacm1kdUpOTktkZXNuS1dDY19GSjY3aXYyeg==",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-threads-home-1793954238194291100",
    "durationMs": 16604
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

积点消耗说明

每份主页资料消耗 0.8 积点,附带作品免费。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试