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. 7. 28.Verified 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이며 서비스 수수료가 포함되어 있습니다.