TikTok 首页推荐 API
同步查询 TikTok 公开数据,空结果和失败免费。
请求后直接返回结果,无需生成任务或轮询。
打开产品页与 API Tester接口地址与鉴权
GET https://api.goanyapi.com/api/v1/tiktok/feed使用 Authorization: Bearer YOUR_API_KEY 鉴权。参数放在查询字符串中,不发送请求体。
输入参数
| 参数 | 类型 | 位置 | 必填 | 约束与默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | string | Header | 是 | Bearer YOUR_API_KEY | 当前账户 API Key |
cursor | string | Query | 否 | 默认: 0 | 数字字符串。首屏为 0,后续仅使用返回的 nextCursor;不按条数推算。 |
count | integer | Query | 否 | 默认: 20; 固定: 20 | 固定请求 20 条;实际返回可能更少。 |
请求示例
GET /api/v1/tiktok/feed?cursor=0&count=20
Authorization: Bearer YOUR_API_KEY输出参数
成功返回 HTTP 200。保留返回记录中的 null、空字符串和缺失业务字段;统计值 0 是有效值。只返回下表公开字段,不包含内部执行信息。
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 成功为 ok |
message | string | 请求说明 |
data.creditsUsed | number | 本次扣除积分;空结果为 0 |
data.remainingCredits | number | 请求结算后的账户余额 |
data.items | array | 当前页作品,空结果为 [] |
data.hasMore | boolean | 数据是否报告还有后续结果;不保证返回下一页游标 |
data.nextCursor | string | null | 返回的下一页游标,未提供时为 null;即使 hasMore=true,也不得自行猜造游标 |
data.pageSize | integer | 固定请求上限 20 |
data.items[].id | string | 作品 ID |
data.items[].desc | string | 作品描述 |
data.items[].createTime | number | Unix 秒时间戳 |
data.items[].isAd | boolean | 广告标志 |
data.items[].author | object | 作者信息 |
data.items[].stats | object | 互动统计 |
data.items[].statsV2 | object | 字符串统计 |
data.items[].video | object | 视频媒体信息 |
data.items[].author.id | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.uniqueId | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.nickname | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.signature | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.secUid | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.avatarThumb | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.avatarMedium | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.avatarLarger | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.verified | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.privateAccount | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].author.createTime | string | number | boolean | null | 返回的公开作者字段,允许缺失或为空 |
data.items[].video.id | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.desc | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.createTime | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.duration | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.width | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.height | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.ratio | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.cover | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.originCover | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.dynamicCover | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.playAddr | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].video.downloadAddr | string | number | null | 返回的公开媒体字段,允许缺失或为空 |
data.items[].stats.diggCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.shareCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.commentCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.playCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.collectCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.followerCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.followingCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.heartCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.heart | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.videoCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.friendCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].stats.viewCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.diggCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.shareCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.commentCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.playCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.collectCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.followerCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.followingCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.heartCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.heart | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.videoCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.friendCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.items[].statsV2.viewCount | number | string | null | 返回的统计值,允许缺失或为空 |
真实响应示例
以下保存自实际成功响应,经过公开字段白名单处理;列表仅节选前两条,示例不包含账户余额和本次扣费字段。真实接口还会返回 creditsUsed 和 remainingCredits,金额由当前配置决定。展示示例不会请求接口或扣费。
{
"code": "ok",
"message": "ok",
"data": {
"items": [
{
"id": "7693207580608384286",
"desc": "Good morning #viral #fyp#dance#school#friend",
"createTime": 1791214511,
"isAd": false,
"author": {
"id": "7518625995999904823",
"uniqueId": "wtfkebba",
"nickname": "Kebba",
"signature": "📍MI\n170k/200k\nSc/insta/yt: wtfkebba\nCollabs:ceesayk158@gmail.com\nCheck out @Lovershoe.To🇺🇸 shoes",
"secUid": "MS4wLjABAAAAhiE3XKYucx7Yez2Qh6CFUeEGFjeYf4hwUySlFQ11UqLwhqsXfOBa1i62GVcl0OxV",
"avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=f2ee4bad&x-expires=1794646800&x-signature=RRJTx5Au8IgsAgPxYOWGXCjRIIM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=73cd5ae9&x-expires=1794646800&x-signature=hMFTebVSEIjvbQyrLpmz%2BdNSyVo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=6936eacd&x-expires=1794646800&x-signature=vXPW4Zy1cNoQ52JN5%2Fvre4vszTo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"verified": false,
"privateAccount": false
},
"stats": {
"diggCount": 2200000,
"shareCount": 93600,
"commentCount": 12500,
"playCount": 16900000,
"collectCount": 191700
},
"statsV2": {
"diggCount": "2200000",
"shareCount": "93600",
"commentCount": "12500",
"playCount": "16900000",
"collectCount": "191708"
},
"video": {
"id": "7693207580608384286",
"duration": 9,
"width": 720,
"height": 1280,
"ratio": "720p",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocFG6WhqwAofE3aBEtP8XRwBV6DfIHcGEvhAED~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=9RdE9ZqXdXLeIjtoCaJSpumhtkI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocK5h4I8MQ22CH2MAfWCqfj1vC8bVPIQQlAeIh~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=sEA8X9cI546LYOjhyYNJ%2BAnDsmM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owfUw8aVwBEFcuhIBIfPtPAF3vGA7qZPDERDET~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ZqEemqQw8FNgelPDN5HWknF458I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oIfRIEGvhta3nBPD37BkELcwAQF7EqA8wfDVUE/?a=1988&bti=ODszNWYuMDE6&&bt=1099&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=OjM6aDQ4M2g4aTU8Z2Y7NkBpanFzc3A5cjl2ZTMzaTczNEA1MV8tMS02XzExYWEtMjEzYSNkc3FvMmRrMC5hLS1kMTJzcw%3D%3D&expire=1794648888&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=a711186f29d4cfd3366e0d202ff9c159&tk=tt_chain_token&btag=e000b0000"
}
},
{
"id": "7689116773324541214",
"desc": "9月24日,华盛顿DC街头,中国人以最热烈的方式“欢迎”习近平访美。欢迎央视新闻报道。",
"createTime": 1790262021,
"isAd": false,
"author": {
"id": "7414635498722214954",
"uniqueId": "yifeng.su.ii",
"nickname": "YiFeng Su II",
"signature": "欢迎投稿爆料👊\n中国不需要谁指明方向,自由民主就是方向!\n因为有共产党,作为中国人实在太丢脸,反共光荣,亲共可耻👊\n\n欢迎朋友们关注我的 X 谢谢。",
"secUid": "MS4wLjABAAAAyPwVzO0msWnWyqPe4vb3quBeDrTpNGBM6om5E_EPwfTy5SAiJEt38s9lZRFEIr2V",
"avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=58c6e663&x-expires=1794646800&x-signature=W%2FKMU%2F%2FSEuzH11yYHm4poGzZoaA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=279aaa74&x-expires=1794646800&x-signature=9wKPQBTcsqPnJdE1vdbBctxBSkc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=92b8a921&x-expires=1794646800&x-signature=XFKuV8gR%2B0XvS2ER%2BlNZCGeL4D0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"verified": false,
"privateAccount": false
},
"stats": {
"diggCount": 51300,
"shareCount": 3883,
"commentCount": 2859,
"playCount": 2700000,
"collectCount": 4423
},
"statsV2": {
"diggCount": "51300",
"shareCount": "3883",
"commentCount": "2859",
"playCount": "2700000",
"collectCount": "4423"
},
"video": {
"id": "7689116773324541214",
"duration": 8,
"width": 848,
"height": 464,
"ratio": "480p",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUEA1qSEYCTAzAREymIACFEEsODsytAF3ffBwV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=NLNJPRMoiu3dfMpX6N4H8pvxong%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owqeas1jKQwSIdGIIVnARYGsLDeDACgI1QCq8f~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=dvkj1XwePuoXRFZssMKsYRYaT40%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUEA1qSEYCTAzAREymIACFEEsODsytAF3ffBwV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=d2QWaRz%2FDvZJKdNlSY240Tvkyrs%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-0068c001-tx2/oMwCWfp1vAuIB0BEQk7iAAAqOiWiID7B1F2MqW/?a=1988&bti=ODszNWYuMDE6&&bt=1640&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=Z2VlOWhoO2Q8Z2Y8aDc2OEBpMzhsM3U5cjNtZDMzaTczNEAwNS80MzRfNTQxLmA0MC4xYSNfcmAzMmRjam5hLS1kMTJzcw%3D%3D&expire=1794648887&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=ddd71808b8a1b7dbc065a589055904b7&tk=tt_chain_token&btag=e000b0000",
"downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oQ17q41MAAFIpAiI7ivEB0bQBWCkAcfKt2OBiW/?a=1988&bti=ODszNWYuMDE6&&bt=1899&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=OmU8aGVlZjQ7ZTs8NmYzPEBpMzhsM3U5cjNtZDMzaTczNEBeLzYwXzEyNl4xLS0yYzQxYSNfcmAzMmRjam5hLS1kMTJzcw%3D%3D&expire=1794648887&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=814d3bf328a737b53037091e8ee7658c&tk=tt_chain_token&btag=e000b0000"
}
}
],
"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"}