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/successAu prix du fournisseur
- Success rate
- 100 %Last 30 days · 57 calls
- Latency p50
- 1.7 sp95 4.6 s
- Last verified
- 28 juil. 2026Verified 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
Paramètres
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
page | entier | Facultatif | Page number (starting from 1). Page size is fixed at 10. | 1 |
keyword | chaîne | Facultatif | Optional search keyword. | 美食 |
sortType | chaîne | Facultatif | 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 | chaîne | Facultatif | 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 | chaîne | Facultatif | 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 | entier | Facultatif | Maximum raw like count. | |
likeCountMin | entier | Facultatif | Minimum raw like count. | |
shareCountMax | entier | Facultatif | Maximum raw share count. | |
shareCountMin | entier | Facultatif | Minimum raw share count. | |
commentCountMax | entier | Facultatif | Maximum raw comment count. | |
commentCountMin | entier | Facultatif | Minimum raw comment count. | |
followerCountMax | entier | Facultatif | Maximum raw creator follower count. | |
followerCountMin | entier | Facultatif | Minimum raw creator follower count. | |
interactionCountMax | entier | Facultatif | Maximum raw interaction count. | |
interactionCountMin | entier | Facultatif | Minimum raw interaction count. | |
- Paramètres de requête
pageentierFacultatifPage number (starting from 1). Page size is fixed at 10.
Exemple :
1keywordchaîneFacultatifOptional search keyword.
Exemple :
美食sortTypechaîneFacultatifSorting 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.
Exemple :
COMPREHENSIVEvideoTypechaîneFacultatifVideo type filter. Available Values: - `ALL`: All video types. - `XINGTU_VIDEO`: Xingtu commercial videos. - `NATURAL_VIDEO`: Natural videos. One of: ALL, XINGTU_VIDEO, NATURAL_VIDEO.
Exemple :
ALLcontentTypechaîneFacultatifTop-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.
Exemple :
ALLlikeCountMaxentierFacultatifMaximum raw like count.
likeCountMinentierFacultatifMinimum raw like count.
shareCountMaxentierFacultatifMaximum raw share count.
shareCountMinentierFacultatifMinimum raw share count.
commentCountMaxentierFacultatifMaximum raw comment count.
commentCountMinentierFacultatifMinimum raw comment count.
followerCountMaxentierFacultatifMaximum raw creator follower count.
followerCountMinentierFacultatifMinimum raw creator follower count.
interactionCountMaxentierFacultatifMaximum raw interaction count.
interactionCountMinentierFacultatifMinimum raw interaction count.
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
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());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.02952/success, frais de service inclus.