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/successAl precio del proveedor
Success rate: 100 %Last 30 days · 57 calls
Latency p50: 1.7 sp95 4.6 s
Last verified: 28 jul 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 onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parámetros

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Parámetros de consulta
`page`	entero	Opcional	Page number (starting from 1). Page size is fixed at 10.	`1`
`keyword`	cadena	Opcional	Optional search keyword.	`美食`
`sortType`	cadena	Opcional	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`	cadena	Opcional	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`	cadena	Opcional	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`	entero	Opcional	Maximum raw like count.
`likeCountMin`	entero	Opcional	Minimum raw like count.
`shareCountMax`	entero	Opcional	Maximum raw share count.
`shareCountMin`	entero	Opcional	Minimum raw share count.
`commentCountMax`	entero	Opcional	Maximum raw comment count.
`commentCountMin`	entero	Opcional	Minimum raw comment count.
`followerCountMax`	entero	Opcional	Maximum raw creator follower count.
`followerCountMin`	entero	Opcional	Minimum raw creator follower count.
`interactionCountMax`	entero	Opcional	Maximum raw interaction count.
`interactionCountMin`	entero	Opcional	Minimum raw interaction count.

Parámetros de consulta
pageenteroOpcional
Page number (starting from 1). Page size is fixed at 10.
Ejemplo: 1
keywordcadenaOpcional
Optional search keyword.
Ejemplo: 美食
sortTypecadenaOpcional
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.
Ejemplo: COMPREHENSIVE
videoTypecadenaOpcional
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.
Ejemplo: ALL
contentTypecadenaOpcional
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.
Ejemplo: ALL
likeCountMaxenteroOpcional
Maximum raw like count.
likeCountMinenteroOpcional
Minimum raw like count.
shareCountMaxenteroOpcional
Maximum raw share count.
shareCountMinenteroOpcional
Minimum raw share count.
commentCountMaxenteroOpcional
Maximum raw comment count.
commentCountMinenteroOpcional
Minimum raw comment count.
followerCountMaxenteroOpcional
Maximum raw creator follower count.
followerCountMinenteroOpcional
Minimum raw creator follower count.
interactionCountMaxenteroOpcional
Maximum raw interaction count.
interactionCountMinenteroOpcional
Minimum raw interaction count.

Ejemplos de código

Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.

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

La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.02952/success, incluida la tarifa de servicio.