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/successPelo preço do provedor
Success rate: 100%Last 30 days · 57 calls
Latency p50: 1.7 sp95 4.6 s
Last verified: 28 de jul. de 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 onlineEm breveProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`page`	inteiro	Opcional	Page number (starting from 1). Page size is fixed at 10.	`1`
`keyword`	string	Opcional	Optional search keyword.	`美食`
`sortType`	string	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`	string	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`	string	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`	inteiro	Opcional	Maximum raw like count.
`likeCountMin`	inteiro	Opcional	Minimum raw like count.
`shareCountMax`	inteiro	Opcional	Maximum raw share count.
`shareCountMin`	inteiro	Opcional	Minimum raw share count.
`commentCountMax`	inteiro	Opcional	Maximum raw comment count.
`commentCountMin`	inteiro	Opcional	Minimum raw comment count.
`followerCountMax`	inteiro	Opcional	Maximum raw creator follower count.
`followerCountMin`	inteiro	Opcional	Minimum raw creator follower count.
`interactionCountMax`	inteiro	Opcional	Maximum raw interaction count.
`interactionCountMin`	inteiro	Opcional	Minimum raw interaction count.

Parâmetros de consulta
pageinteiroOpcional
Page number (starting from 1). Page size is fixed at 10.
Exemplo: 1
keywordstringOpcional
Optional search keyword.
Exemplo: 美食
sortTypestringOpcional
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.
Exemplo: COMPREHENSIVE
videoTypestringOpcional
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.
Exemplo: ALL
contentTypestringOpcional
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.
Exemplo: ALL
likeCountMaxinteiroOpcional
Maximum raw like count.
likeCountMininteiroOpcional
Minimum raw like count.
shareCountMaxinteiroOpcional
Maximum raw share count.
shareCountMininteiroOpcional
Minimum raw share count.
commentCountMaxinteiroOpcional
Maximum raw comment count.
commentCountMininteiroOpcional
Minimum raw comment count.
followerCountMaxinteiroOpcional
Maximum raw creator follower count.
followerCountMininteiroOpcional
Minimum raw creator follower count.
interactionCountMaxinteiroOpcional
Maximum raw interaction count.
interactionCountMininteiroOpcional
Minimum raw interaction count.

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no 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());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.02952/success, incluindo a taxa de serviço.