WellbyteWellbyte

POST /v1/douyin/billboard/fetch_hot_total_search_list

Fetch search hot list

stable · 2 credits per success

Get the search list；page_num: Page number；page_size: Number of items per page；date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24；keyword: Search keyword；Request Example；```json；{；"page_num": 1,；"page_size": 10,；"date_window": 24,；"keyword": "抖音"；}；```；Search list

Sign up for 500 credits and run with your own API key. Sign up free

Request

keywordstringbody

搜索关键字

page_numintegerbody

页码

page_sizeintegerbody

每页数量

date_windowintegerbody

时间窗口(小时)，可选 1

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/billboard/fetch_hot_total_search_list' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"咖啡","page_num":null,"page_size":null,"date_window":null}'

Response

Sample captured 2026-08-27

data{

code:0

data{

page_num:1

page_size:10

search_list[ 2 items ]

total_count:889

}

meta{

endpoint:"douyin.billboard.fetch_hot_total_search_list"

cache_hit:false

elapsed_ms:0

request_id:"req_sample"

credits_charged:0

}

message:"ok"

}

History

No calls yet. Get one green run first, then switch to your own data.

POST /v1/douyin/billboard/fetch_hot_total_search_list

Fetch search hot list

stable · 2 credits per success

Get the search list；page_num: Page number；page_size: Number of items per page；date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24；keyword: Search keyword；Request Example；```json；{；"page_num": 1,；"page_size": 10,；"date_window": 24,；"keyword": "抖音"；}；```；Search list

Request parameters

Name	Type	In	Required	Description	Example
keyword	string	body	no	搜索关键字	咖啡
page_num	integer	body	no	页码	demo
page_size	integer	body	no	每页数量	demo
date_window	integer	body	no	时间窗口(小时)，可选 1	demo

Response fields

Field dictionary coming soon — the executable panel shows the live shape.

Errors

code	HTTP	Meaning	Billed
40001	400	Invalid parameters	no
40102	401	Invalid or revoked API Key	no
40201	402	Insufficient credits	no
40402	404	Resource not found	no
42201	422	Quality gate failed	no
42901	429	Rate limit exceeded	no
50401	504	Upstream timeout	no
50201	502	Upstream error	no

Billing

Success costs 2 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.

Sign up for 500 credits and run with your own API key. Sign up free

Request

keywordstringbody

搜索关键字

page_numintegerbody

页码

page_sizeintegerbody

每页数量

date_windowintegerbody

时间窗口(小时)，可选 1

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/billboard/fetch_hot_total_search_list' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"咖啡","page_num":null,"page_size":null,"date_window":null}'

Response

Sample captured 2026-08-27

data{

code:0

data{

page_num:1

page_size:10

search_list[ 2 items ]

total_count:889

}

meta{

endpoint:"douyin.billboard.fetch_hot_total_search_list"

cache_hit:false

elapsed_ms:0

request_id:"req_sample"

credits_charged:0

}

message:"ok"

}

History

No calls yet. Get one green run first, then switch to your own data.