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.
- Price
- $0.02952/successプロバイダー原価
- Success rate
- 100%Last 30 days · 57 calls
- Latency p50
- 1.7 sp95 4.6 s
- Last verified
- 2026/07/28Verified working
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=ALLPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.02952/success です。サービス料を含みます。