Douyin trending content search with engagement filters

justoneapi.x.douyin-hot-search-v1

Searches Douyin (TikTok China) content with optional keyword, category, video-type, ranking, pagination, engagement, and creator-follower filters.

Price: $0.02952/successAt provider cost
Success rate: 100%Last 30 days · 57 calls
Latency p50: 1.7 sp95 4.6 s
Last verified: Jul 28, 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=ALL

Preview

Try onlineComing soonProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`page`	integer	Optional	Page number (starting from 1). Page size is fixed at 10.	`1`
`keyword`	string	Optional	Optional search keyword.	`美食`
`sortType`	string	Optional	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`	string	Optional	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`	string	Optional	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`	integer	Optional	Maximum raw like count.
`likeCountMin`	integer	Optional	Minimum raw like count.
`shareCountMax`	integer	Optional	Maximum raw share count.
`shareCountMin`	integer	Optional	Minimum raw share count.
`commentCountMax`	integer	Optional	Maximum raw comment count.
`commentCountMin`	integer	Optional	Minimum raw comment count.
`followerCountMax`	integer	Optional	Maximum raw creator follower count.
`followerCountMin`	integer	Optional	Minimum raw creator follower count.
`interactionCountMax`	integer	Optional	Maximum raw interaction count.
`interactionCountMin`	integer	Optional	Minimum raw interaction count.

Query parameters
pageintegerOptional
Page number (starting from 1). Page size is fixed at 10.
Example: 1
keywordstringOptional
Optional search keyword.
Example: 美食
sortTypestringOptional
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.
Example: COMPREHENSIVE
videoTypestringOptional
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.
Example: ALL
contentTypestringOptional
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.
Example: ALL
likeCountMaxintegerOptional
Maximum raw like count.
likeCountMinintegerOptional
Minimum raw like count.
shareCountMaxintegerOptional
Maximum raw share count.
shareCountMinintegerOptional
Minimum raw share count.
commentCountMaxintegerOptional
Maximum raw comment count.
commentCountMinintegerOptional
Minimum raw comment count.
followerCountMaxintegerOptional
Maximum raw creator follower count.
followerCountMinintegerOptional
Minimum raw creator follower count.
interactionCountMaxintegerOptional
Maximum raw interaction count.
interactionCountMinintegerOptional
Minimum raw interaction count.

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

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());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.02952/success, including the service fee.