公开资料与字段解读

TikTok 话题作品 API

使用 TikTok 话题作品 API,直接输入完整话题 URL 或标签名,查看公开视频、作者和互动字段;仅在返回有效的新游标时继续。

每次非空成功请求 1 积分;空结果和失败不扣费,每页单独计费。

每页固定请求 20 条,实际按返回结果展示。下一页是独立计费请求。

GET示例响应
https://api.goanyapi.com/api/v1/tiktok/hashtag-posts?url=https%3A%2F%2Fwww.tiktok.com%2Ftag%2Ffyp&cursor=0&count=20
可视化

运行后在这里查看可视化

响应会自动整理成指标、列表和表格,和右侧 JSON 一一对应。

运行后在这里查看响应

填入演示参数即可预览示例响应,不消耗积分;登录后可用自己的参数发起真实请求。

从一个标签读取具体作品

TikTok 话题作品 API 返回指定标签下可获取的一页公开作品。直接输入 URL 或名称即可,无需先查话题详情、取得 ID。列表可用于展示视频描述、作者、封面与公开互动,而不是只看一个话题计数。完整参数与响应表见接口文档。

话题输入如何对应作品记录

请求示例为 GET /api/v1/tiktok/hashtag-posts?challenge_name=fyp&cursor=0&count=20,请求头携带 Bearer API Key。也可改传 url=https://www.tiktok.com/tag/fyp,不能同时传名称。以上仅为请求写法,非本次实测。返回后逐条读取 data.items[]:id 标识作品,desc 是作品文案,author、stats、video 分别提供作者、统计与媒体字段。要进一步核对单条作品,可使用视频详情 API。

data.items[].id / data.items[].desc
作品标识与描述。保留 ID 原值;描述不是话题资料说明,也不是字幕、转录或自动分析结论。
data.items[].author
可返回账号标识、uniqueId、昵称、头像和认证标记。昵称是展示文本,不能当作唯一账号标识。
data.items[].createTime
作品创建时间字段,与应用查询、保存结果的时间不同;格式化日期时说明所用时区。
data.items[].stats / data.items[].statsV2
可读取播放、点赞、评论、分享、收藏计数;两组统计分别保留,评论数不包含评论正文,也不是转化数据。
data.items[].video
可含封面、播放与下载地址、时长和尺寸。按实际返回使用,不承诺永久地址或无水印下载。
data.hasMore / data.nextCursor / data.pageSize
分别说明继续状态、下一游标和请求量;游标存在但 hasMore=false 时同样停止,不推算总页数。
TikTok 字段关系示意,非原站截图、非本次实测响应。字段含义见相邻文字。
TikTok 字段关系示意 · 非原站截图,非本次实测响应。图中仅使用协议字段名;完整说明见本页原生文字。

请求条数与翻页边界

count 固定请求 20,data.pageSize 表示请求量;实际条数读 data.items.length,可能更少,也不代表话题总量。仅当 data.hasMore=true 且 data.nextCursor 有效、不同于本次游标时继续。保持 URL 或名称不变,将返回值传入 cursor;任一条件不满足就停止,不用条数相加猜游标,不承诺完整历史或固定排序。

区分作品内容、作者与分页信息

展示作品列表

用返回描述、作者和可用封面生成列表;缺失、null、空串按实际保留,0 与 false 不当成缺失。

读取公开互动

自行排序、归类、去重或比较属于应用后续处理,接口不直接输出主题评分。

按请求核对费用

每次非空成功请求独立计费;解析 URL 和标识处理无额外收费,空结果和失败免费。

常见问题

可以。使用 HTTPS、tiktok.com 或 www.tiktok.com 的 /tag/ 完整 URL,或不带 #、不含空白的 challenge_name,二选一。不支持 vm/vt 短链。

不需要。需要话题本身的标题与计数时才单独查详情,作品查询直接使用 URL 或名称。

固定请求量不等于实际条数。看 items 数组长度,不把 pageSize 当实际条数、总量或绝对输出上限。

不提供描述、评论的自由关键词搜索,也不保证热度或时间排序;不能据此声称覆盖全部历史、私密或已删除作品。

不是,是同步 GET 查询。查看保存示例不发新请求;真实查询及下一页各自按当前配置费率结算,响应包含 creditsUsed 与 remainingCredits。