Douyin trending content search with engagement filters
justoneapi.x.douyin-hot-search-v1Searches Douyin (TikTok China) content with optional keyword, category, video-type, ranking, pagination, engagement, and creator-follower filters.
- 价格
- $0.02952/success按供应商原价
- 成功率
- 100%近 30 天 · 57 次
- 延迟 p50
- 1.7 秒p95 4.6 秒
- 最后验证
- 2026年7月28日实测可用
GEThttps://toolswitch.dev/v1/tools/justoneapi.x.douyin-hot-search-v1?page=1&keyword=%E7%BE%8E%E9%A3%9F&sortType=COMPREHENSIVE&videoType=ALL&contentType=ALL预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
page | 整数 | 可选 | Page number (starting from 1). Page size is fixed at 10. | 1 |
keyword | 字符串 | 可选 | Optional search keyword. | 美食 |
sortType | 字符串 | 可选 | Sorting criteria for hot content results. Available Values: - `COMPREHENSIVE`: Comprehensive ranking. - `HIGH_INTERACTION`: Highest interaction count. - `HIGH_LIKE`: Highest like count. - `HIGH_COMMENT`: Highest comment count. - `HIGH_SHARE`: Highest share count. One of: COMPREHENSIVE, HIGH_INTERACTION, HIGH_LIKE, HIGH_COMMENT, HIGH_SHARE. | COMPREHENSIVE |
videoType | 字符串 | 可选 | Video type filter. Available Values: - `ALL`: All video types. - `XINGTU_VIDEO`: Xingtu commercial videos. - `NATURAL_VIDEO`: Natural videos. One of: ALL, XINGTU_VIDEO, NATURAL_VIDEO. | ALL |
contentType | 字符串 | 可选 | Top-level content type. Only one content type can be selected. Available Values: - `ALL`: All content types. - `FASHION`: Fashion. - `TECHNOLOGY`: Technology. - `SCIENCE`: Science. - `PHOTOGRAPHY`: Photography and videography. - `FOOD`: Food. - `MOTHER_BABY`: Mother and baby. - `PARENTING`: Parentin One of: ALL, FASHION, TECHNOLOGY, SCIENCE, PHOTOGRAPHY, FOOD, MOTHER_BABY, PARENTING, DRAMA, GAME, AUTOMOTIVE, ANIMAL. | ALL |
likeCountMax | 整数 | 可选 | Maximum raw like count. | |
likeCountMin | 整数 | 可选 | Minimum raw like count. | |
shareCountMax | 整数 | 可选 | Maximum raw share count. | |
shareCountMin | 整数 | 可选 | Minimum raw share count. | |
commentCountMax | 整数 | 可选 | Maximum raw comment count. | |
commentCountMin | 整数 | 可选 | Minimum raw comment count. | |
followerCountMax | 整数 | 可选 | Maximum raw creator follower count. | |
followerCountMin | 整数 | 可选 | Minimum raw creator follower count. | |
interactionCountMax | 整数 | 可选 | Maximum raw interaction count. | |
interactionCountMin | 整数 | 可选 | Minimum raw interaction count. | |
- 查询参数
page整数可选Page number (starting from 1). Page size is fixed at 10.
示例:
1keyword字符串可选Optional search keyword.
示例:
美食sortType字符串可选Sorting criteria for hot content results. Available Values: - `COMPREHENSIVE`: Comprehensive ranking. - `HIGH_INTERACTION`: Highest interaction count. - `HIGH_LIKE`: Highest like count. - `HIGH_COMMENT`: Highest comment count. - `HIGH_SHARE`: Highest share count. One of: COMPREHENSIVE, HIGH_INTERACTION, HIGH_LIKE, HIGH_COMMENT, HIGH_SHARE.
示例:
COMPREHENSIVEvideoType字符串可选Video type filter. Available Values: - `ALL`: All video types. - `XINGTU_VIDEO`: Xingtu commercial videos. - `NATURAL_VIDEO`: Natural videos. One of: ALL, XINGTU_VIDEO, NATURAL_VIDEO.
示例:
ALLcontentType字符串可选Top-level content type. Only one content type can be selected. Available Values: - `ALL`: All content types. - `FASHION`: Fashion. - `TECHNOLOGY`: Technology. - `SCIENCE`: Science. - `PHOTOGRAPHY`: Photography and videography. - `FOOD`: Food. - `MOTHER_BABY`: Mother and baby. - `PARENTING`: Parentin One of: ALL, FASHION, TECHNOLOGY, SCIENCE, PHOTOGRAPHY, FOOD, MOTHER_BABY, PARENTING, DRAMA, GAME, AUTOMOTIVE, ANIMAL.
示例:
ALLlikeCountMax整数可选Maximum raw like count.
likeCountMin整数可选Minimum raw like count.
shareCountMax整数可选Maximum raw share count.
shareCountMin整数可选Minimum raw share count.
commentCountMax整数可选Maximum raw comment count.
commentCountMin整数可选Minimum raw comment count.
followerCountMax整数可选Maximum raw creator follower count.
followerCountMin整数可选Minimum raw creator follower count.
interactionCountMax整数可选Maximum raw interaction count.
interactionCountMin整数可选Minimum raw interaction count.
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.douyin-hot-search-v1?page=1&keyword=%E7%BE%8E%E9%A3%9F&sortType=COMPREHENSIVE&videoType=ALL&contentType=ALL' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/justoneapi.x.douyin-hot-search-v1?page=1&keyword=%E7%BE%8E%E9%A3%9F&sortType=COMPREHENSIVE&videoType=ALL&contentType=ALL",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.douyin-hot-search-v1?page=1&keyword=%E7%BE%8E%E9%A3%9F&sortType=COMPREHENSIVE&videoType=ALL&contentType=ALL", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为预览版,地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.02952/success 计费,已含服务费。