​
接口说明

TikTok Search API 按关键词搜索 TikTok 内容，返回搜索结果及对应信息。

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

​
请求URL

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

​
请求头

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

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

​
请求参数

参数必填类型说明
targetYesstring搜索关键词
optionsNoobject仅处理下列开放参数；未列出的字段忽略，内部参数不可覆盖。

​
options 参数说明

参数必填类型说明
maxPagesNointeger本次请求翻几页，默认 1，最大 5，按实际返回条数计费，更多数据用返回的游标续取
默认值: 1
最小值: 1
最大值: 5
typeNostring搜索类型, 默认 video；可选值：video / user
可用值: [“video”, “user”]
cursorNostring续页: 上次输出的 pagination.cursor

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

每次默认1页，最多5页；页数必须为正整数，超过5按5处理。

​
响应值

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

​
返回参数 data 说明

返回值类型说明
videosobject[]视频结果, 字段同 tiktok-works 作品; options.type=user 时为空
usersobject[]用户结果; 仅 options.type=user
countnumbervideos + users 条数
paginationobject下一页游标及是否还有数据；平台限制或到底时cursor为null、hasMore为false。

​
data.videos[] 字段说明

返回值类型说明
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背景音乐
authorobject作者

​
data.videos[].stats 字段说明

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

​
data.videos[].music 字段说明

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

​
data.videos[].author 字段说明

返回值类型说明
idstring | null作者 id
uniqueIdstring | null用户名
nicknamestring | null昵称
secUidstring | nullsecUid
avatarstring | null头像
verifiedboolean是否认证
privateAccountboolean是否私密账号
profileUrlstring | null主页链接

​
data.users[] 字段说明

返回值类型说明
userIdstring用户 id
secUidstring | nullsecUid (tiktok-works 可直接传 options.secUid)
usernamestring | null用户名
nicknamestring | null昵称
signaturestring | null简介
avatarstring | null头像
profileUrlstring | null主页链接
followersCountnumber | null粉丝数
likesCountnumber | null获赞数
verifyReasonstring | null认证说明, 如 institution account; 未认证为 null

​
data.pagination 字段说明

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

​
请求示例

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

​
返回示例

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

{
  "code": 0,
  "message": "ok",
  "pointCost": 8.8,
  "data": {
    "videos": [
      {
        "workId": "7704275624587840790",
        "parentId": "7693181669365236758",
        "type": "video",
        "videoId": "7704275624587840790",
        "url": "https://www.tiktok.com/@dream_life_daily/video/7704275624587840790",
        "desc": "funny kitten videos #tiktokgrowthchallenge #cat #funnycat #funnycatsoftiktok #fyp ",
        "content": "funny kitten videos #tiktokgrowthchallenge #cat #funnycat #funnycatsoftiktok #fyp ",
        "createTime": 1793791461,
        "createdISO": "2026-11-04T11:24:21.000Z",
        "publishedAt": 1793791461000,
        "cover": "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/osK5Eh36gNzRAIseqvQ3XVF0EpFWkxfKBEBEDB~tplv-tiktokx-origin.image?dr=14575&x-expires=1794124800&x-sig...",
        "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/osvBsEvrOTZ0iEYuaAIKirCU2QgwaSiFBBP5i/?a=1988&bti=ODszNWYuMDE6&&bt=1399&ft=-Csk_mm...",
        "duration": 61,
        "width": 576,
        "height": 1024,
        "stats": {
          "diggCount": 279,
          "shareCount": 88,
          "commentCount": 5,
          "playCount": 4187,
          "collectCount": 37,
          "repostCount": 0
        },
        "isPinned": false,
        "isAd": false,
        "hashtags": [
          "tiktokgrowthchallenge"
        ],
        "music": {
          "id": "7704275646259694358",
          "title": "original sound",
          "authorName": "Funny Binge"
        },
        "author": {
          "id": "7693181669365236758",
          "uniqueId": "dream_life_daily",
          "nickname": "Funny Binge",
          "secUid": "MS4wLjABAAAAH-V48G3lzu90zM792LdzPCC321Svtn_2TNYk2kbmyrVrcsWfRWBkYMnKtcVlGr3e",
          "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/8f57b1ffd6e9df98ee3da66220a77d18~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=3fabaa...",
          "verified": false,
          "privateAccount": false,
          "profileUrl": "https://www.tiktok.com/@dream_life_daily"
        }
      }
    ],
    "users": [],
    "count": 11,
    "pagination": {
      "cursor": "12:202611061639069A8AEB72879A3B072285",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-tiktok-search-1793954343843401000",
    "durationMs": 4478
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 11,
    "pointCost": 8.8
  }
}

​
积点消耗说明

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

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

在线调试