TikTok API
TikTok 话题标签视频 API
列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。
POST/v1/run/tiktok.hashtag_videos
可用率
99.40%
30d · 168 次调用
请求数
168
30d · 按周,近 12 周
响应时间
17.9s
中位数 · 30d
服务商网络
按流量排序的服务商
服务商
每次请求封顶 US$0.00661 条结果US$0.0003310 条结果US$0.003320 条结果US$0.0066(封顶)按实际返回的内容计费。调低返回数量上限即可少付,而且无论返回多少,单次请求都不会超过封顶价。
试一试
发出你的第一个请求
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `playCount`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个视频确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。只返回某个字段的四舍五入值或缩写值的数据源,不算返回了该字段。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"authorHandle": "alex_rivera",
"authorImage": "https://example.com/image.jpg",
"authorName": "Alex Rivera",
"authorUserId": "Alex Rivera",
"authorVerified": true,
"collectCount": 12500,
"commentCount": 12500,
"createdUtc": 12.5,
"durationSeconds": 12.5,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"likeCount": 12500,
"playCount": 12500,
"shareCount": 13,
"text": "A short example description of this item.",
"url": "https://example.com/page",
"videoUrl": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TiktokHashtagVideosResponse {
data: {
items: {
authorHandle?: string;
authorImage?: string;
authorName?: string;
authorUserId?: string;
authorVerified?: boolean;
collectCount?: number;
commentCount?: number;
createdUtc: number;
durationSeconds?: number;
id: string;
image?: string;
likeCount?: number;
playCount?: number;
shareCount?: number;
text?: string;
url: string;
videoUrl?: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/tiktok.hashtag_videos
curl -X POST https://api.getanyapi.com/v1/run/tiktok.hashtag_videos \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag":"cooking","limit":3}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| hashtag | string | "cooking"要获取视频的 TikTok 话题标签,不带 # 前缀(例如 booktok)。 |
| limit | integer | 3最多返回的结果数(1-20,默认 20)。 |
| requireFields | array | 可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `playCount`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个视频确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。只返回某个字段的四舍五入值或缩写值的数据源,不算返回了该字段。 |
| 响应 | ||
| data | object | |
| data.items | object[] | Recent TikTok video records for the hashtag. Populated whenever the provider has data for the entity. |
| data.items[].authorHandle | string | Username of the video's creator, without the @ prefix. Empty when the upstream omits it. |
| data.items[].authorImage | string | Author's avatar image URL. Signed and short-lived, so the query string is load-bearing and kept intact. |
| data.items[].authorName | string | Author's display name. |
| data.items[].authorUserId | string | Author's numeric TikTok user id. |
| data.items[].authorVerified | boolean | Whether the author's account carries a TikTok verification badge. |
| data.items[].collectCount | integer | Number of times the video was saved. |
| data.items[].commentCount可设为必填 | integer | Number of comments on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].durationSeconds | number | Video duration in seconds. |
| data.items[].id | string | The video's numeric TikTok ID, as a string. Populated whenever the provider has data for the entity. |
| data.items[].image | string | URL of the video's cover/thumbnail image, with tracking query params stripped. Empty when the upstream omits it. |
| data.items[].likeCount可设为必填 | integer | Number of likes on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].playCount可设为必填 | integer | Number of views/plays of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].shareCount可设为必填 | integer | Number of shares of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count. |
| data.items[].text | string | The video caption text. Empty for videos with no caption. |
| data.items[].url | string | Canonical tiktok.com URL of the video, with tracking query params stripped. Populated whenever the provider has data for the entity. |
| data.items[].videoUrl | string | Playable video URL. Signed and short-lived, so the query string is load-bearing and kept intact. |
| found | boolean | Whether any videos were returned for the hashtag. |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0008 |
| 价格(/千次请求) | USD | US$0.80 |
常见问题
关于 TikTok 话题标签视频 API
AnyAPI 的 TikTok 话题标签视频 API 只需一次 POST 请求 /v1/run/tiktok.hashtag_videos,就以统一格式的 JSON 返回 TikTok 数据。列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。AnyAPI 会在 3 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.80 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 话题标签视频 API 调用中有 99.4% 成功,响应时间中位数为 17.9 秒,共测量 168 次调用。
费用:每千次请求 US$0.80 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 TikTok 话题标签视频 API 调用中有 99.4% 成功,响应时间中位数为 17.9 秒,共测量 168 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。
更多接口
TikTok 的其他接口
主页/千次请求 US$0.45 起主页视频/千次请求 US$0.70 起视频转录文本/千次请求 US$1.20 起关键词搜索/千次请求 US$0.70 起视频/千次请求 US$0.45 起视频评论/千次请求 US$0.70 起用户搜索/千次请求 US$0.70 起广告库广告/千次请求 US$1.20 起广告库搜索/千次请求 US$1.20 起广告透明度搜索/千次请求 US$0.50 起受众人口统计/千次请求 US$18.00 起评论回复/千次请求 US$0.90 起粉丝/千次请求 US$0.95 起关注列表/千次请求 US$0.95 起直播/千次请求 US$1.20 起照片/千次请求 US$1.20 起播放列表视频/千次请求 US$1.20 起主页联系方式/千次请求 US$1.16 起主页播放列表/千次请求 US$1.20 起主页地区/千次请求 US$1.20 起主页转发/千次请求 US$1.20 起搜索话题标签/千次请求 US$1.20 起搜索图文/千次请求 US$1.20 起搜索建议/千次请求 US$0.95 起搜索热门结果/千次请求 US$0.90 起歌曲/千次请求 US$0.90 起歌曲视频/千次请求 US$0.90 起热门广告搜索/千次请求 US$1.20 起热门推荐流/千次请求 US$0.80 起热门话题标签/千次请求 US$1.20 起视频下载/千次请求 US$0.90 起视频转录文本(完整版)/千分钟音频 US$5.94 起