API 文档

TikTok 探索页作品 API

同步查询 TikTok 公开数据,空结果和失败免费。

测试 API

请求后直接返回结果,无需生成任务或轮询。

打开产品页与 API Tester

接口地址与鉴权

GET https://api.goanyapi.com/api/v1/tiktok/explore

使用 Authorization: Bearer YOUR_API_KEY 鉴权。参数放在查询字符串中,不发送请求体。

输入参数

参数类型位置必填约束与默认值说明
AuthorizationstringHeader是Bearer YOUR_API_KEY当前账户 API Key
category_typestringQuery是120 / 119 / 104 / 112 / 100 / 107 / 101 / 105 / 102 / 103 / 109 / 108 / 117 / 116 / 118 / 113 / 106 / 110 / 114 / 115 / 111分类 ID;示例:104
cursorstringQuery否默认: 0数字字符串。首屏为 0,后续仅使用返回的 nextCursor;不按条数推算。
countintegerQuery否默认: 20; 固定: 20固定请求 20 条;实际返回可能更少。

分类 ID 使用下表中的数字字符串。页面可直接下拉选择,默认 104(喜剧);切换分类会重置分页游标。

支持的分类

分类 ID分类英文名称
120全部All
119唱歌与舞蹈Singing & Dancing
104喜剧Comedy
112体育Sports
100动漫与漫画Anime & Comics
107情感关系Relationship
101节目Shows
105日常生活Daily Life
102美容护理Beauty Care
103游戏Games
109穿搭Outfit
108剧情Drama
117健身与健康Fitness & Health
116教育Education
118科技Technology
113动物Animals
106家庭Family
110对口型Lipsync
114社会Society
115汽车Cars
111美食Food

请求示例

GET /api/v1/tiktok/explore?category_type=104&cursor=0&count=20
Authorization: Bearer YOUR_API_KEY

输出参数

成功返回 HTTP 200。保留返回记录中的 null、空字符串和缺失业务字段;统计值 0 是有效值。只返回下表公开字段,不包含内部执行信息。

字段类型说明
codestring成功为 ok
messagestring请求说明
data.creditsUsednumber本次扣除积分;空结果为 0
data.remainingCreditsnumber请求结算后的账户余额
data.itemsarray当前页作品,空结果为 []
data.hasMoreboolean数据是否报告还有后续结果;不保证返回下一页游标
data.nextCursorstring | null返回的下一页游标,未提供时为 null;即使 hasMore=true,也不得自行猜造游标
data.pageSizeinteger固定请求上限 20
data.items[].idstring作品 ID
data.items[].descstring作品描述
data.items[].createTimenumberUnix 秒时间戳
data.items[].isAdboolean广告标志
data.items[].authorobject作者信息
data.items[].statsobject互动统计
data.items[].statsV2object字符串统计
data.items[].videoobject视频媒体信息
data.items[].author.idstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.uniqueIdstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.nicknamestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.signaturestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.secUidstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.avatarThumbstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.avatarMediumstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.avatarLargerstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.verifiedstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.privateAccountstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].author.createTimestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.items[].video.idstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.descstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.createTimestring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.durationstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.widthstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.heightstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.ratiostring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.coverstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.originCoverstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.dynamicCoverstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.playAddrstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].video.downloadAddrstring | number | null返回的公开媒体字段,允许缺失或为空
data.items[].stats.diggCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.shareCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.commentCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.playCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.collectCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.followerCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.followingCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.heartCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.heartnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.videoCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.friendCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].stats.viewCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.diggCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.shareCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.commentCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.playCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.collectCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.followerCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.followingCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.heartCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.heartnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.videoCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.friendCountnumber | string | null返回的统计值,允许缺失或为空
data.items[].statsV2.viewCountnumber | string | null返回的统计值,允许缺失或为空

真实响应示例

以下保存自实际成功响应,经过公开字段白名单处理;列表仅节选前两条,示例不包含账户余额和本次扣费字段。真实接口还会返回 creditsUsed 和 remainingCredits,金额由当前配置决定。展示示例不会请求接口或扣费。

{
  "code": "ok",
  "message": "ok",
  "data": {
    "items": [
      {
        "id": "7697417641027259662",
        "desc": "You can move out of your Mexican household but you can’t stop being Mexican, tried so hard to store my pots and pans in a cute way but they belong in the oven… is it just a Mexican thing to use the oven as a storage space for pots n pans ?  - - #relatable #mexican #mexicanmemes #funny ",
        "createTime": 1792194730,
        "isAd": false,
        "author": {
          "id": "7006760049079878661",
          "uniqueId": "milklard",
          "nickname": "Milk lard",
          "signature": "TWITCH n GYM <3",
          "secUid": "MS4wLjABAAAAs8cmTgFigZN2SkC39aSu65y1D34RWlZl6s4bIEXok2XJsv9sWucS2q5QF9kgO5v2",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=66f4abab&x-expires=1794646800&x-signature=Tw8Q0%2Bqjc6j9ih7HRaGGYFNwrq0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=52a79d42&x-expires=1794646800&x-signature=I3ZVh7DkIge9Gt6nWejP4dz%2Fhlg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=df8da3b6&x-expires=1794646800&x-signature=BPpXMkaW%2Fj0vfaO%2FfkdoWTmsMzo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 57800,
          "shareCount": 4888,
          "commentCount": 318,
          "playCount": 851600,
          "collectCount": 7453
        },
        "statsV2": {
          "diggCount": "57800",
          "shareCount": "4888",
          "commentCount": "318",
          "playCount": "851600",
          "collectCount": "7453"
        },
        "video": {
          "id": "7697417641027259662",
          "duration": 25,
          "width": 720,
          "height": 1280,
          "ratio": "720p",
          "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8utS4sgao42KXkKAAmAgD5dEqh4iPBEBA1iI~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ulumvDwjVnp%2Bz853eI5ip8sJbV8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oMKCRPVSYwvIBaYIBQ4iAfApuBaiIAnZ1HsyiL~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=crFAVhHSOausZ6Qaq6URsFhs7Z4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8utS4sgao42KXkKAAmAgD5dEqh4iPBEBA1iI~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ulumvDwjVnp%2Bz853eI5ip8sJbV8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/ogI93IA17aSusiY04R3BLwQCpHBPAfyRQEDZiV/?a=1988&bti=ODszNWYuMDE6&&bt=1052&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=Z2ZoNTs8ZGQ1ZTY2PDs1OEBpajo0OXI5cnllZTMzZzczNEBgXzJgXzVjNmMxLi1eMDMxYSM1ZF5tMmQ0YDZhLS1kMS9zcw%3D%3D&expire=1794648902&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=6ef50d7bf0fcf8ac559300b7f65292d6&tk=tt_chain_token&btag=e000b8000",
          "downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/oUAQuVnyBEjLRS4sAYiQpbIfHAPs1DBIi3wZCa/?a=1988&bti=ODszNWYuMDE6&&bt=965&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=aTdoNjs8NjlkNGZpZGc8OEBpajo0OXI5cnllZTMzZzczNEA1LjIwNV5eNWIxNS1eYTY0YSM1ZF5tMmQ0YDZhLS1kMS9zcw%3D%3D&expire=1794648902&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=2d7d4a4e513a1f0355d70438d48e42e4&tk=tt_chain_token&btag=e000b8000"
        }
      },
      {
        "id": "7706672760273095950",
        "desc": "This one gets the sarcasm from both mom and dad…#fun #girldad ",
        "createTime": 1794349608,
        "isAd": false,
        "author": {
          "id": "7018543553433830406",
          "uniqueId": "derek_evans",
          "nickname": "Derek_Evans 🦆",
          "signature": "",
          "secUid": "MS4wLjABAAAAEP_720CrhKrszmIVuRxue8KneC3yrJSy7Z_HdMjA08B_5Ny8caB1zApGYooYa2j0",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=23ebee4b&x-expires=1794646800&x-signature=W2abdU%2F44GkHBqyF5hc9dqjWkMc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=d9a72b06&x-expires=1794646800&x-signature=ACoi4quQqpw3Aq7QSo8205A3FCk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=37ac96ff&x-expires=1794646800&x-signature=OzRANAvoMxgwoZDjHsKz8so3OGo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 909500,
          "shareCount": 173000,
          "commentCount": 6327,
          "playCount": 7700000,
          "collectCount": 72100
        },
        "statsV2": {
          "diggCount": "909500",
          "shareCount": "173000",
          "commentCount": "6327",
          "playCount": "7700000",
          "collectCount": "72113"
        },
        "video": {
          "id": "7706672760273095950",
          "duration": 33,
          "width": 720,
          "height": 1280,
          "ratio": "720p",
          "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYCDjzGN5vzeKeRbn3Prke9II0ELQIVLHgAAEO~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=oQlh4Gv60MiFYasWx2ZAnVtOPRA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oY1FnAlezkBStEQVn5FfHCAsnNWuKaQbjtDiIe~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=pfjS5xw8hXivSCBNPWKp2pNyC%2BM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oM2zZiFuTv6UOgzBIiaiED4XIBxLdNtrmAvBy~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=GOEEsrep31kybDB4akVueFQa280%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c004-tx/oEyO2lzUIgXmvixBJ49E6AziC0avtNEZWtvQB/?a=1988&bti=ODszNWYuMDE6&&bt=533&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=NTczZmQ8OWQzPDk1Zzg5NEBpam11eGs5cnFzZTMzZzczNEAwXjM1MzAwXzQxNF80MGI0YSNqMmozMmRrZm1hLS1kMS9zcw%3D%3D&expire=1794648910&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=4bc1e5a94d907ecb5899a3c9fe667fdb&tk=tt_chain_token&btag=e00088000"
        }
      }
    ],
    "hasMore": true,
    "nextCursor": null,
    "pageSize": 20
  }
}

分页

固定请求每页最多 20 条,实际可能更少。只有 hasMore=true 且 nextCursor 为有效字符串时,才使用该值作为下一次的 cursor。不要按返回条数推算游标;如果 hasMore=true 但 nextCursor=null,当前响应无法继续分页。每次下一页都是独立请求并按相同规则计费,不自动翻页。

计费

当前配置下,每次成功请求消耗 1 积分。

非空成功结果按管理员当前配置扣费,空结果与失败不扣费。请求前需要足够余额;并发请求结算时余额不足也会返回 402,不交付未结算的付费结果。详情为空对象或 null、列表无有效记录为无结果;已有记录但个别字段为空,不视为整次空结果。

错误响应

400:参数错误;401:鉴权失败;402:余额不足;429:请求过于频繁;502:请求失败;503:接口或价格尚未配置。错误正文包含 code 和 message,不包含内部地址或凭证。

{"code":"invalid_params","message":"Invalid parameter"}