API 文档

TikTok 话题作品 API

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

测试 API

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

打开产品页与 API Tester

接口地址与鉴权

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

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

输入参数

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

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

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

按名称查询示例:

GET /api/v1/tiktok/hashtag-posts?challenge_name=fyp&cursor=0
Authorization: Bearer YOUR_API_KEY

请求示例

GET /api/v1/tiktok/hashtag-posts?url=https%3A%2F%2Fwww.tiktok.com%2Ftag%2Ffyp&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": "7707082010908445982",
        "desc": "#avengers #avengersdoomsday #marvel #fyp #viral ",
        "createTime": 1794444880,
        "isAd": false,
        "author": {
          "id": "7688534553996198926",
          "uniqueId": "dr.marvel_editz",
          "nickname": "Dr.Marvel",
          "signature": "Marvel edits and\nmovie clips🎥🍿",
          "secUid": "MS4wLjABAAAAq-xpocSSyvz0mdYicQNi2jF4J940TKwA8FiS0djC3_ZjAX3YLgs7JlmB7k3ifBO9",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/50a0add99deaee9f97a35f6dd74d65da~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=c2ad5917&x-expires=1794646800&x-signature=FeqJ9wUHswMJ80Q64rrnMSc%2BYH0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/50a0add99deaee9f97a35f6dd74d65da~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=0a622be8&x-expires=1794646800&x-signature=GZUqiLElmz%2FGBu7qMtXkJDIOcTk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/50a0add99deaee9f97a35f6dd74d65da~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=d356516e&x-expires=1794646800&x-signature=XQLkoDB4mFXcuenIv8wMtpNmh3o%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 141800,
          "shareCount": 18200,
          "commentCount": 951,
          "playCount": 1200000,
          "collectCount": 29900
        },
        "statsV2": {
          "diggCount": "141800",
          "shareCount": "18200",
          "commentCount": "951",
          "playCount": "1200000",
          "collectCount": "29905"
        },
        "video": {
          "id": "7707082010908445982",
          "duration": 532,
          "width": 720,
          "height": 1280,
          "ratio": "720p",
          "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEp2IV4frDAlD8FobQFtERqC3EpArBc9IqfQ1E~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=9HKZcDjc9b2NTUsjBomHxnet2UQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEEOqdREIEAflIL1AqiA84fpVBF2rD9DQkKr9t~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=C5ck5%2B%2FpNzx%2B7W76gwo%2BJD2OADY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIAA1Fpr29flDDU6Rf8BQQEtAVEhETPIrqRqI4~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=n1snMYbRTlFGrtxp5vuRQeJWwgQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c004-tx2/oYD8bEtQ2ED9rFvErVofnq007pQ4BRAf1qIQAE/?a=1988&bti=ODszNWYuMDE6&&bt=253&ft=4KJMyMzm8Zmo03LjMa4jVhHzdpWrKsd.&mime_type=video_mp4&rc=OzU2NDo3Ozg1ZWk5ODdpZkBpM2VkeXA5cmRqZTMzaTczNEAzNF5eYGEwXmMxXy8tMV4vYSNwZzJzMmRzb25hLS1kMTJzcw%3D%3D&expire=1794649443&l=20261112093511E6E5A8A5913BB5016BAD&ply_type=2&policy=2&signature=6de96ad74f5131987c506208694d1b24&tk=tt_chain_token&btag=e000a0000",
          "downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c001-tx2/o8qm6gcjvgfqIQyIQVhAatM3WX8AACd8fRfqXu/?a=1988&bti=ODszNWYuMDE6&&bt=232&ft=4KJMyMzm8Zmo03LjMa4jVhHzdpWrKsd.&mime_type=video_mp4&rc=M2U8NWdnZWllaTVnO2k7M0BpM2VkeXA5cmRqZTMzaTczNEA2YGJhMi02NjUxLTFiMi1eYSNwZzJzMmRzb25hLS1kMTJzcw%3D%3D&expire=1794649443&l=20261112093511E6E5A8A5913BB5016BAD&ply_type=2&policy=2&signature=018098579617bd34435af940f77fadeb&tk=tt_chain_token&btag=e000a0000"
        }
      },
      {
        "id": "7517227615535533334",
        "desc": "#######foruyou #####foeyoupage ######forupage ##########forupage viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral viral kro 🥺🥺",
        "createTime": 1750240948,
        "isAd": false,
        "author": {
          "id": "7400363394282669088",
          "uniqueId": "user01karmavle",
          "nickname": "Hafiza",
          "signature": "♥️Allahmudiallah ♥️ Hafizy Quran ♥️🥰 \ndream 10k followings",
          "secUid": "MS4wLjABAAAA1wnxAwse6pe1mjIHAwfEDgZJWuQC6znPE6Ck-YRamUVt9PtSCQBD2-ISr5_qoh-7",
          "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/207639ea1e038c59e78cbb485b0468b8~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=04bd6c7e&x-expires=1794646800&x-signature=SzLk6l3SDIfqgekFVEmHvGrpSEE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/207639ea1e038c59e78cbb485b0468b8~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=a8e5b588&x-expires=1794646800&x-signature=8aFcPyaXbqg%2FXkTRJYdPhx4MBI4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/207639ea1e038c59e78cbb485b0468b8~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=057fcef2&x-expires=1794646800&x-signature=Y87Tn%2BseJCj2C8M1zO3tlqX0f38%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 129,
          "shareCount": 19,
          "commentCount": 10,
          "playCount": 14900,
          "collectCount": 17
        },
        "statsV2": {
          "diggCount": "129",
          "shareCount": "19",
          "commentCount": "10",
          "playCount": "14900",
          "collectCount": "17"
        },
        "video": {
          "id": "7517227615535533334",
          "duration": 7,
          "width": 576,
          "height": 1024,
          "ratio": "540p",
          "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ogxEvjfrIBxEk0UBRSZDfFWRyyAFBsogMF6oIL~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=w5TSRnB0K3A%2FWyF%2FRihVDQpguhY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/oUqLlWMwXMilpHl05jHsADeIEEfQQIC8AQRueQ~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=kiu%2Bbn9gtjCJYpxWXdIH1tAUdNs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ocqXRYEIIFgoyyUfLjFkSIJfWryvYEABDBoRBx~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=b%2BHH4BFKxgu7Q3WJ%2BOvUZW%2BKjJI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oEFyIkEDDBfFfxnMjooSERWErsF9LRAUvyBEHg/?a=1988&bti=ODszNWYuMDE6&&bt=917&ft=4KJMyMzm8Zmo03LjMa4jVhHzdpWrKsd.&mime_type=video_mp4&rc=ZTloOGczZztkaTgzOjlpZUBpM2t5PHI5cmY7NDMzbzczNUBfXmAuNGFfXjMxXmFeM181YSNfcmJkMmRrbTZhLS1kMTFzcw%3D%3D&expire=1794648918&l=20261112093511E6E5A8A5913BB5016BAD&ply_type=2&policy=2&signature=821923e6815ec2b92d27ef7f22303651&tk=tt_chain_token&btag=e000b0000",
          "downloadAddr": "https://video-useast5-bp.us.tiktok.com/b0441178e8ae85224b68f39e38ac196e/6af82b56/kmoat/mps/logo/v2/r/p/v24044gl0000d198pcnog65og9evuhb0/9d6d6c5673754f01bca95fc8a445574e/b1ff870bcba54deab4b7c81707f48c22/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&eid=1286&ft=4KUERMzm8Zmo03LjMa4jVhHzdpWrKsd.&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmaDo4NztpPGY0aTg2OWZnZ0BpM2t5PHI5cmY7NDMzbzczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiMxMjFeYDJeXy0xNDQyMzM2YSNfcmJkMmRrbTZhLS1kMTFzcw%3D%3D&definition=720p&du=7&item_id=7517227615535533334&l=20261112093511E6E5A8A5913BB5016BAD&logo_type=tiktok_m&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&user_text=user01karmavle&btag=e000b0000"
        }
      }
    ],
    "hasMore": false,
    "nextCursor": "2",
    "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"}