接口说明

TikTok Works API 获取 TikTok 账号或频道的作品列表。

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

请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/tiktok-works

请求头

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

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

请求参数

参数必填类型说明
targetYesstring主页链接; 也可直接传用户名 (可带 @)
optionsNoobject仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。

options 参数说明

参数必填类型说明
secUidNostring资料里的 secUid; 给了就不再请求主页
cursorNostring续页: 上次输出的 pagination.cursor

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

每次只取一页,用返回游标续取。

响应值

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

返回参数 data 说明

返回值类型说明
typestringType
可用值: [“works”]
secUidstring作者 secUid (续取时传 options.secUid 可省一次主页请求)
worksobject[]作品列表
paginationobject游标为时间戳, 传 options.cursor 续取

data.works[] 字段说明

返回值类型说明
workIdstring视频 id
parentIdstring作者 id
typestring作品类型
可用值: [“video”]
videoIdstring视频 id (同 workId)
urlstring视频链接
descstring | null正文
contentstring | null正文 (同 desc)
createTimenumber | null发布时间秒级时间戳
createdISOstring | null发布时间 ISO
publishedAtnumber | null发布时间毫秒时间戳
coverstring | null封面
playUrlstring | null播放地址 (有时效)
durationnumber | null时长 (秒)
widthnumber | null宽
heightnumber | null高
statsobject计数
isPinnedboolean是否置顶
isAdboolean是否广告
hashtagsstring[]话题名 (不含 #)
musicobject | null背景音乐

data.works[].stats 字段说明

返回值类型说明
diggCountnumber | null点赞数
shareCountnumber | null分享数
commentCountnumber | null评论数
playCountnumber | null播放数
collectCountnumber | null收藏数
repostCountnumber | null转发数

data.works[].music 字段说明

返回值类型说明
idstring音乐 id
titlestring | null音乐名
authorNamestring | null音乐作者

data.pagination 字段说明

返回值类型说明
cursorstring | null下一页游标, 传回 options.cursor 续取
hasMoreboolean是否还有更多

请求示例

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

返回示例

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

{
  "code": 0,
  "message": "ok",
  "pointCost": 4.0,
  "data": {
    "type": "works",
    "secUid": "MS4wLjABAAAAPZWNdkF_cmVSPCvV0Y6MCsH29mlAOlMOX3ikzGvlfMm3K6OMZv-JrRImpEHxdIMI",
    "works": [
      {
        "workId": "7704861353076346143",
        "parentId": "53279706535428096",
        "type": "video",
        "videoId": "7704861353076346143",
        "url": "https://www.tiktok.com/@scout2015/video/7704861353076346143",
        "desc": "This is really hard😔💔 #dogmom #childhooddog #surgery #recovery ",
        "content": "This is really hard😔💔 #dogmom #childhooddog #surgery #recovery ",
        "createTime": 1793927835,
        "createdISO": "2026-11-06T01:17:15.000Z",
        "publishedAt": 1793927835000,
        "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ogEAIIALLEAfDjAAWnI2fUIlx3KzGebEqpqVPt~tplv-tiktokx-origin.image?dr=10395&x-expires=179412480...",
        "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/ocyqBdkuBAy1QR9XAIFl7KVDTffQlrSEEEBPtE/?a=1988&bti=ODszNWYuMDE6&&bt=1333&ft=Bich7V...",
        "duration": 10,
        "width": 720,
        "height": 1280,
        "stats": {
          "diggCount": 19,
          "shareCount": 1,
          "commentCount": 2,
          "playCount": 407,
          "collectCount": 1,
          "repostCount": 0
        },
        "isPinned": false,
        "isAd": false,
        "hashtags": [
          "dogmom"
        ],
        "music": {
          "id": "7684150368565250075",
          "title": "Paper Moon Static",
          "authorName": "Marnie Cusk"
        }
      }
    ],
    "pagination": {
      "cursor": "1793547411238",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-tiktok-works-1793954375877083400",
    "durationMs": 16864
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

积点消耗说明

每条主体结果消耗 0.8 积点。

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

在线调试