API 文档

TikTok 视频详情 API

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

测试 API

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

打开产品页与 API Tester

接口地址与鉴权

GET https://api.goanyapi.com/api/v1/tiktok/video-detail

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

输入参数

参数类型位置必填约束与默认值说明
AuthorizationstringHeader是Bearer YOUR_API_KEY当前账户 API Key
item_idstringQuery二选一^[0-9]+$视频 ID;示例:7686957509826923808。与 url 二选一,不能同时传。
urlstringQuery二选一^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/video/[0-9]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$完整 TikTok 链接;示例:https://www.tiktok.com/@spidey.glow/video/7686957509826923808。与 item_id 二选一,不能同时传。允许分享参数及片段,不支持短链接;解析不额外收费。

支持完整 URL:https://www.tiktok.com/@spidey.glow/video/7686957509826923808。url 与 item_id 必须二选一,不能同时提供。分享参数、片段和末尾斜杠会自动移除;暂不支持短链接。URL 格式处理不额外收费。

请求示例

GET /api/v1/tiktok/video-detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40spidey.glow%2Fvideo%2F7686957509826923808
Authorization: Bearer YOUR_API_KEY

输出参数

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

字段类型说明
codestring成功为 ok
messagestring请求说明
data.creditsUsednumber本次扣除积分;空结果为 0
data.remainingCreditsnumber请求结算后的账户余额
data.itemobject | null视频作品详情;无结果为 null
data.item.idstring作品 ID
data.item.descstring作品描述
data.item.createTimenumberUnix 秒时间戳
data.item.isAdboolean广告标志
data.item.authorobject作者信息
data.item.statsobject互动统计
data.item.statsV2object字符串统计
data.item.videoobject视频媒体信息
data.item.author.idstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.uniqueIdstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.nicknamestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.signaturestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.secUidstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.avatarThumbstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.avatarMediumstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.avatarLargerstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.verifiedstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.privateAccountstring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.author.createTimestring | number | boolean | null返回的公开作者字段,允许缺失或为空
data.item.video.idstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.descstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.createTimestring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.durationstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.widthstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.heightstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.ratiostring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.coverstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.originCoverstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.dynamicCoverstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.playAddrstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.video.downloadAddrstring | number | null返回的公开媒体字段,允许缺失或为空
data.item.stats.diggCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.shareCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.commentCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.playCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.collectCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.followerCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.followingCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.heartCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.heartnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.videoCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.friendCountnumber | string | null返回的统计值,允许缺失或为空
data.item.stats.viewCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.diggCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.shareCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.commentCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.playCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.collectCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.followerCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.followingCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.heartCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.heartnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.videoCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.friendCountnumber | string | null返回的统计值,允许缺失或为空
data.item.statsV2.viewCountnumber | string | null返回的统计值,允许缺失或为空

真实响应示例

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

{
  "code": "ok",
  "message": "ok",
  "data": {
    "item": {
      "id": "7686957509826923808",
      "desc": "Comment “SANTA” if you need one 🤭🎄 #christmas #christmasiscoming #projector #merrychristmas #christmasdecor ",
      "createTime": 1789759268,
      "isAd": false,
      "author": {
        "id": "7672400417817625622",
        "uniqueId": "spidey.glow",
        "nickname": "SpideyGlow",
        "signature": "",
        "secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
        "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=a34c0f1e&x-expires=1794646800&x-signature=YMzBmDgoFv2S4Kui2XY0XXEDhwI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=18965771&x-expires=1794646800&x-signature=k%2FtqwEg%2FG2ewpHJw%2FxdKOhdeRm0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=eb2f6582&x-expires=1794646800&x-signature=8MwRsymAfh8mqWKXlfe5Z%2BzlRKk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "verified": false,
        "privateAccount": false
      },
      "stats": {
        "diggCount": 11100,
        "shareCount": 7166,
        "commentCount": 491,
        "playCount": 1000000,
        "collectCount": 2423
      },
      "statsV2": {
        "diggCount": "11100",
        "shareCount": "7166",
        "commentCount": "491",
        "playCount": "1000000",
        "collectCount": "2423"
      },
      "video": {
        "id": "7686957509826923808",
        "duration": 14,
        "width": 576,
        "height": 1024,
        "ratio": "540p",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/owHQfADrKH1DkFRNqzPJ6CmEQIebBDgQunkYEV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=LtUxvaSud4oEjRkn9Wfiz2T1YwA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oYEsyqotmiQaZSh1AlBgIjItfdCaPABznByIVi~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=7L%2BLsb1IUpQZz7Zufap2OlxC9sw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oMyimjqyIZyCzGVAntZBfBlIdEAiCUsoEzi1Ih~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=Q%2FrsN7LCrnTEr0lVcZ0C7TzAUas%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/ow1EVtFrPQDeJkgA6K9QfDEzqbIHRqNDmDmYHB/?a=1988&bti=ODszNWYuMDE6&&bt=1087&ft=4KJMyMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=aTM6NzY1aDY5PDY0ZjxmZ0Bpajp0cmw5cjVyZDMzZjczNUA0NjBjLWNiXzUxYS0tM2AxYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&expire=1794648888&l=202611120934347C1B176E04FFD2014F20&ply_type=2&policy=2&signature=7960f205a17931084ce957cd56b59cab&tk=tt_chain_token&btag=e000b8000",
        "downloadAddr": "https://video-useast5-bp.us.tiktok.com/b63e11495ffdb3e6ff708d815695a650/6af82b38/kmoat/mps/logo/v3/r/p/v26044gc0000damot2fog65icocql7ig/d3a2b34d8a654b1299c10af3e9527c90/07f34a1c8d363dc39fbe34e3c4004545/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&ft=4KUERMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2Y1PDZkNDw1ZThkZzY1NkBpajp0cmw5cjVyZDMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiM2NDJiYy1gNi4xMzUxX15hYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&definition=720p&du=15&item_id=7686957509826923808&l=202611120934347C1B176E04FFD2014F20&logo_type=tiktok_creator&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&sign_params=item_id%2Cuser_text&user_text=spidey.glow&btag=e000b8000"
      }
    }
  }
}

计费

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

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

错误响应

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

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