API 文档

TikTok 用户作品 API

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

测试 API

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

打开产品页与 API Tester

接口地址与鉴权

GET https://api.goanyapi.com/api/v1/tiktok/user-posts

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

输入参数

参数类型位置必填约束与默认值说明
AuthorizationstringHeader是Bearer YOUR_API_KEY当前账户 API Key
usernamestringQuery二选一^[A-Za-z0-9._]+$用户名;示例:spidey.glow。与 url 二选一,不能同时传。
urlstringQuery二选一^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$完整 TikTok 链接;示例:https://www.tiktok.com/@spidey.glow。与 username 二选一,不能同时传。允许分享参数及片段,不支持短链接;解析不额外收费。
cursorstringQuery否默认: 0数字字符串。首屏为 0,后续仅使用返回的 nextCursor;不按条数推算。
countintegerQuery否默认: 15; 固定: 15固定请求 15 条;实际返回可能更少。

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

直接传主页 URL 或用户名(不带 @);使用 username=spidey.glow 或 url,二选一。无需先查询 ID。服务端自动完成标识处理,不产生额外获取费用,仅按最终非空成功作品结果结算一次;空结果和失败不扣费。后续分页保持相同 URL 或名称,仅更改 cursor。旧版 sec_uid 输入请改为 URL 或名称。

按名称查询示例:

GET /api/v1/tiktok/user-posts?username=spidey.glow&cursor=0
Authorization: Bearer YOUR_API_KEY

请求示例

GET /api/v1/tiktok/user-posts?url=https%3A%2F%2Fwww.tiktok.com%2F%40spidey.glow&cursor=0&count=15
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固定请求上限 15
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": "7688000247930309920",
        "desc": "Comment “CHRISTMAS” if you need this 🎄👇 #christmas #christmasgift #christmasdecor #santa #christmasiscoming ",
        "createTime": 1790002051,
        "isAd": false,
        "author": {
          "id": "7672400417817625622",
          "uniqueId": "spidey.glow",
          "nickname": "SpideyGlow",
          "signature": "",
          "secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=4babe6a8&x-expires=1794646800&x-signature=L1xXQL6lgzSEukL%2FUee7vsdWmGY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=3c32fc27&x-expires=1794646800&x-signature=oCM8plBfPRp69Viiu7KrbRfYko8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=77a532ec&x-expires=1794646800&x-signature=VNupCvmJLvBS4NlYIIyGjijt9gw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 642,
          "shareCount": 461,
          "commentCount": 53,
          "playCount": 59100,
          "collectCount": 168
        },
        "statsV2": {
          "diggCount": "642",
          "shareCount": "461",
          "commentCount": "53",
          "playCount": "59100",
          "collectCount": "168"
        },
        "video": {
          "id": "7688000247930309920",
          "duration": 13,
          "width": 576,
          "height": 1024,
          "ratio": "540p",
          "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/ogYaBfX3DDOqF4LEUxEQUrE4sBmIVAxQfORwLA~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=w0nOvfJTYcRbdvZaG4mZ69AbI9Y%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oQSLImED8VfDxfRBQqUxEXAI4PFS3RAsLUBXlQ~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=DG1c21HZZMtlEoyXBSg9Qq9Ae%2F0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/o0IlXRBq4sxQLFx3fAaD4QCEmXDfAUVaLIC3EU~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=sRsNqDjDrRjkRI2XcK993VzBToM%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/ocLsDffUEEbmE4QXVQqQFB3xIWRUA3xA6D3BL6/?a=1988&bti=ODszNWYuMDE6&&bt=1131&ft=aEeq8qT0mIoPD12zEwZI3wUpyjAbMeF~O5&mime_type=video_mp4&rc=M2QzZjk0ZmRkZzUzNjtoOkBpM3Fpd3k5cm9uZDMzZjczNUAvLzUuLWA1NjQxLjYwMGJjYSMtL21eMmQ0MmxhLS1kMTNzcw%3D%3D&expire=1794648924&l=2026111209351141FBC8FD2946BE013520&ply_type=2&policy=2&signature=c01baf5c6aac64ca6541ef107b59f63f&tk=tt_chain_token&btag=e000b0000",
          "downloadAddr": "https://video-useast5-bp.us.tiktok.com/dce8044a8c76dc4460f55572e45776bc/6af82b5c/kmoat/mps/logo/v2/r/p/v26044gc0000daok5l7og65vatpf2n00/8535125446364b0cbb8058ad7ef9d972/06e56f18f2b4636c145cb9d8da38976f/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&eid=1286&ft=aERFuqT0mIoPD12zEwZI3wUpyjAbMeF~O5&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmNTw8aGc7M2VmZTk5NzU4OEBpM3Fpd3k5cm9uZDMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiM0YWM0XjI1Xy0xMDEyLjA1YSMtL21eMmQ0MmxhLS1kMTNzcw%3D%3D&definition=720p&du=14&item_id=7688000247930309920&l=2026111209351141FBC8FD2946BE013520&logo_type=tiktok_m&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&user_text=spidey.glow&btag=e000b0000"
        }
      },
      {
        "id": "7687843512632528161",
        "desc": "Comment “SANTA” if you need one 🤭🎄 #christmas #christmasiscoming #projector #merrychristmas #christmasdecor ",
        "createTime": 1789965567,
        "isAd": false,
        "author": {
          "id": "7672400417817625622",
          "uniqueId": "spidey.glow",
          "nickname": "SpideyGlow",
          "signature": "",
          "secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=4babe6a8&x-expires=1794646800&x-signature=L1xXQL6lgzSEukL%2FUee7vsdWmGY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=3c32fc27&x-expires=1794646800&x-signature=oCM8plBfPRp69Viiu7KrbRfYko8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=77a532ec&x-expires=1794646800&x-signature=VNupCvmJLvBS4NlYIIyGjijt9gw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 108,
          "shareCount": 27,
          "commentCount": 17,
          "playCount": 5767,
          "collectCount": 13
        },
        "statsV2": {
          "diggCount": "108",
          "shareCount": "27",
          "commentCount": "17",
          "playCount": "5767",
          "collectCount": "13"
        },
        "video": {
          "id": "7687843512632528161",
          "duration": 9,
          "width": 576,
          "height": 1024,
          "ratio": "540p",
          "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/o8IApiB8BQ1fW3WEP1ZoAWzwFrECIxrEBFtXio~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=RnI25S2wTHkLKEzZQttmswXpMzc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/o0QCBW1zQIAFXwFQrltpwfBHWoi3EABG1IEIai~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=4oZwWWrK2Wk4ZpVJ4%2Fcsq6nTJ9c%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oUqFuDfEnQsQqrsmIQBTRWASfgQFFJE4Du6Ltw~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=bj8jvxvtg0LS5uIOWS%2BD%2BjJV7NQ%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-0068-euttp/o0yICt4WiiAEcWQoEIPBz1ErFXtBp31wWBQfAQ/?a=1988&bti=ODszNWYuMDE6&&bt=1433&ft=aEeq8qT0mIoPD12zEwZI3wUpyjAbMeF~O5&mime_type=video_mp4&rc=OzszNTM8PDM3MzY6aTRnOkBpM3FsN3E5cnRlZDMzZjczNUAxLi80YGJiXi0xLjAyNDJgYSNfai0vMmRzNmxhLS1kMTNzcw%3D%3D&expire=1794648920&l=2026111209351141FBC8FD2946BE013520&ply_type=2&policy=2&signature=e73b2540a51c975b4489271861123d93&tk=tt_chain_token&btag=e000b0000",
          "downloadAddr": "https://video-useast5-bp.us.tiktok.com/cece39029f9aa1a6349408a737a67286/6af82b58/kmoat/mps/logo/v2/r/p/v26044gc0000daob9qvog65n240imnb0/b4b2a72c7ac54ccb9b154ad7c3246382/647807a59c16252074d53c7c9485ea45/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&eid=1286&ft=aERFuqT0mIoPD12zEwZI3wUpyjAbMeF~O5&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmNTY3NjpkOGVlZjhkZjo1N0BpM3FsN3E5cnRlZDMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiM1My9gYTEuNmAxYDQvXl9fYSNfai0vMmRzNmxhLS1kMTNzcw%3D%3D&definition=720p&du=10&item_id=7687843512632528161&l=2026111209351141FBC8FD2946BE013520&logo_type=tiktok_m&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&user_text=spidey.glow&btag=e000b0000"
        }
      }
    ],
    "hasMore": true,
    "nextCursor": "1788892633304",
    "pageSize": 15
  }
}

分页

固定请求每页最多 15 条,实际可能更少。只有 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"}