TikTok API
TikTok 搜索热门结果 API
搜索 TikTok 上某个关键词的热门结果(文案、播放量、点赞数、评论数、分享数),支持游标分页。
POST/v1/run/tiktok.search_top
可用率
99.88%
30d · 1,667 次调用
请求数
1,667
30d · 按周,近 12 周
响应时间
4.1s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `nextCursor`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条记录确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"author": "Alex Rivera",
"authorImage": "https://example.com/image.jpg",
"authorName": "Alex Rivera",
"authorUserId": "Alex Rivera",
"caption": "A short example description of this item.",
"comments": 12500,
"contentType": "A short example description of this item.",
"createdUtc": 12.5,
"durationSeconds": 12.5,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"likes": 12500,
"saves": 42,
"shares": 13,
"url": "https://example.com/page",
"videoUrl": "https://example.com/page",
"views": 12500
}
],
"nextCursor": "example"
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TiktokSearchTopResponse {
data: {
items: {
author: string;
authorImage?: string;
authorName?: string;
authorUserId?: string;
caption: string;
comments: number;
contentType: string | null;
createdUtc?: number;
durationSeconds?: number;
id: string;
image?: string;
likes: number;
saves?: number;
shares: number;
url: string;
videoUrl?: string;
views: number;
}[];
nextCursor: string | null;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/tiktok.search_top
curl -X POST https://api.getanyapi.com/v1/run/tiktok.search_top \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"funny"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "funny"要搜索的关键词(例如 "funny")。 |
| cursor | string | 上一次响应返回的分页游标。 |
| publishTime | enum | 时间范围筛选:yesterday、this-week、this-month、last-3-months、last-6-months、all-time。 |
| region | string | 代理位置的两字母国家代码(例如 US、GB、FR)。 |
| requireFields | array | 可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `nextCursor`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条记录确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。 |
| sortBy | enum | 排序方式:relevance、most-liked、date-posted。 |
| 响应 | ||
| data | object | |
| data.items | object[] | Populated whenever the provider has data for the entity. |
| data.items[].author | string | Populated whenever the provider has data for the entity. |
| 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[].caption | string | Populated whenever the provider has data for the entity. |
| data.items[].comments | integer | |
| data.items[].contentType可设为必填 | string | TikTok's own label for the post format, such as video, or null when the serving source does not report it. |
| data.items[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity. |
| data.items[].durationSeconds | number | Media duration in seconds. |
| data.items[].id | string | Populated whenever the provider has data for the entity. |
| data.items[].image | string | URL of the item's cover image. Signed and short-lived, so the query string is load-bearing and kept intact. |
| data.items[].likes | integer | |
| data.items[].saves | integer | |
| data.items[].shares | integer | |
| data.items[].url | string | 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. |
| data.items[].views | integer | |
| data.nextCursor可设为必填 | string | Opaque cursor for the next page of results, or null when this lane has no more. Pass it back as cursor to continue. |
| found | boolean | |
| 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.0009 |
| 价格(/千次请求) | USD | US$0.90 |
常见问题
关于 TikTok 搜索热门结果 API
AnyAPI 的 TikTok 搜索热门结果 API 只需一次 POST 请求 /v1/run/tiktok.search_top,就以统一格式的 JSON 返回 TikTok 数据。搜索 TikTok 上某个关键词的热门结果(文案、播放量、点赞数、评论数、分享数),支持游标分页。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.90 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 搜索热门结果 API 调用中有 99.9% 成功,响应时间中位数为 4.1 秒,共测量 1,667 次调用。
费用:每千次请求 US$0.90 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
搜索 TikTok 上某个关键词的热门结果(文案、播放量、点赞数、评论数、分享数),支持游标分页。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 TikTok 搜索热门结果 API 调用中有 99.9% 成功,响应时间中位数为 4.1 秒,共测量 1,667 次调用。这些是 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$0.80 起直播/千次请求 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$1.20 起热门推荐流/千次请求 US$0.80 起热门话题标签/千次请求 US$1.20 起视频下载/千次请求 US$0.90 起视频转录文本(完整版)/千分钟音频 US$5.94 起