TikTok 话题详情 API
同步查询 TikTok 公开数据,空结果和失败免费。
请求后直接返回结果,无需生成任务或轮询。
打开产品页与 API Tester接口地址与鉴权
GET https://api.goanyapi.com/api/v1/tiktok/hashtag-detail使用 Authorization: Bearer YOUR_API_KEY 鉴权。参数放在查询字符串中,不发送请求体。
输入参数
| 参数 | 类型 | 位置 | 必填 | 约束与默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | string | Header | 是 | Bearer YOUR_API_KEY | 当前账户 API Key |
challenge_name | string | Query | 二选一 | ^[^#\s]+$ | 话题名称;示例:fyp。与 url 二选一,不能同时传。 |
url | string | Query | 二选一 | ^https://(www\.)?tiktok\.com/tag/[^/?#\s\\]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$ | 完整 TikTok 链接;示例:https://www.tiktok.com/tag/fyp。与 challenge_name 二选一,不能同时传。允许分享参数及片段,不支持短链接;解析不额外收费。 |
支持完整 URL:https://www.tiktok.com/tag/fyp。url 与 challenge_name 必须二选一,不能同时提供。分享参数、片段和末尾斜杠会自动移除;暂不支持短链接。URL 格式处理不额外收费。
请求示例
GET /api/v1/tiktok/hashtag-detail?url=https%3A%2F%2Fwww.tiktok.com%2Ftag%2Ffyp
Authorization: Bearer YOUR_API_KEY输出参数
成功返回 HTTP 200。保留返回记录中的 null、空字符串和缺失业务字段;统计值 0 是有效值。只返回下表公开字段,不包含内部执行信息。
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 成功为 ok |
message | string | 请求说明 |
data.creditsUsed | number | 本次扣除积分;空结果为 0 |
data.remainingCredits | number | 请求结算后的账户余额 |
data.hashtag | object | null | 资料对象;无结果为 null |
data.stats | object | null | 统计字段 |
data.statsV2 | object | null | 字符串形式的大数统计,保留实际值 |
data.hashtag.id | string | number | boolean | null | 话题标识字段;查询话题作品可直接使用话题 URL 或 challenge_name,无需先获取此值 |
data.hashtag.title | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.desc | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.coverThumb | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.coverMedium | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.coverLarger | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.profileThumb | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.profileMedium | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.profileLarger | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.hashtag.isCommerce | string | number | boolean | null | 公开资料字段,允许缺失或为空 |
data.stats.diggCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.shareCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.commentCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.playCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.collectCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.followerCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.followingCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.heartCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.heart | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.videoCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.friendCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.stats.viewCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.diggCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.shareCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.commentCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.playCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.collectCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.followerCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.followingCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.heartCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.heart | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.videoCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.friendCount | number | string | null | 返回的统计值,允许缺失或为空 |
data.statsV2.viewCount | number | string | null | 返回的统计值,允许缺失或为空 |
真实响应示例
以下保存自实际成功响应,经过公开字段白名单处理;列表仅节选前两条,示例不包含账户余额和本次扣费字段。真实接口还会返回 creditsUsed 和 remainingCredits,金额由当前配置决定。展示示例不会请求接口或扣费。
{
"code": "ok",
"message": "ok",
"data": {
"hashtag": {
"id": "229207",
"title": "fyp",
"desc": "",
"coverThumb": "",
"coverMedium": "",
"coverLarger": "",
"profileThumb": "",
"profileMedium": "",
"profileLarger": "",
"isCommerce": false
},
"stats": {
"videoCount": 0,
"viewCount": 131746900000000
},
"statsV2": {
"videoCount": "9519133676",
"viewCount": "131746936474533"
}
}
}计费
当前配置下,每次成功请求消耗 1 积分。
非空成功结果按管理员当前配置扣费,空结果与失败不扣费。请求前需要足够余额;并发请求结算时余额不足也会返回 402,不交付未结算的付费结果。详情为空对象或 null、列表无有效记录为无结果;已有记录但个别字段为空,不视为整次空结果。
错误响应
400:参数错误;401:鉴权失败;402:余额不足;429:请求过于频繁;502:请求失败;503:接口或价格尚未配置。错误正文包含 code 和 message,不包含内部地址或凭证。
{"code":"invalid_params","message":"Invalid parameter"}