WellbyteWellbyte

POST /v1/douyin/search/fetch_video_search_v1

Fetch video search V1

stable · 13 credits per success

Fetch video content search results from Douyin App based on a keyword.；This API is focused on video search results only.；Notes；Set `cursor` to 0 and `search_id` to an empty string for the first request.；Each returned video includes rich details: author, video info, music, statistics, etc.；Also returns a set of suggested keywords (`guide_search_words`) for user guidance.；keyword: Search keyword, e…

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

Request

cursorintegerbody

偏移游标，用于翻页，从上一次请求返回的响应中获取

keywordstringbody

关键词

backtracestringbody

翻页回溯标识，用于翻页，从上一次请求返回的响应中获取

search_idstringbody

搜索ID，用于翻页，从上一次请求返回的响应中获取

sort_typestringbody

排序方式：0=综合排序 1=最多点赞 2=最新发布

content_typestringbody

内容类型：0=不限 1=视频 2=图片 3=文章

publish_timestringbody

发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年

filter_durationstringbody

视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_video_search_v1' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"cursor":null,"keyword":"咖啡","backtrace":"demo","search_id":"demo","sort_type":"demo","content_type":"demo","publish_time":"demo","filter_duration":"demo"}'

Response

Sample captured 2026-08-27

data{

code:0

data{

data[ 2 items ]

extra{ 5 items }

cursor:8

log_pb{ 2 items }

ad_info{ 0 items }

has_more:1

backtrace:

"J6aGE6HAjYfQrWVjdpCA4koXHeq2D+xd626XetlNTOcDaD1vfAp9QZlMsoEl42R1WqHHFYJwGEfrOQ51..."

aweme_list:null

status_code:0

guide_search_words[ 2 items ]

global_doodle_config{ 1 item }

}

meta{

endpoint:"douyin.search.fetch_video_search_v1"

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/search/fetch_video_search_v1

Fetch video search V1

stable · 13 credits per success

Fetch video content search results from Douyin App based on a keyword.；This API is focused on video search results only.；Notes；Set `cursor` to 0 and `search_id` to an empty string for the first request.；Each returned video includes rich details: author, video info, music, statistics, etc.；Also returns a set of suggested keywords (`guide_search_words`) for user guidance.；keyword: Search keyword, e…

Request parameters

Name	Type	In	Required	Description	Example
cursor	integer	body	no	偏移游标，用于翻页，从上一次请求返回的响应中获取	demo
keyword	string	body	no	关键词	咖啡
backtrace	string	body	no	翻页回溯标识，用于翻页，从上一次请求返回的响应中获取	demo
search_id	string	body	no	搜索ID，用于翻页，从上一次请求返回的响应中获取	demo
sort_type	string	body	no	排序方式：0=综合排序 1=最多点赞 2=最新发布	demo
content_type	string	body	no	内容类型：0=不限 1=视频 2=图片 3=文章	demo
publish_time	string	body	no	发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年	demo
filter_duration	string	body	no	视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上	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 13 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

cursorintegerbody

偏移游标，用于翻页，从上一次请求返回的响应中获取

keywordstringbody

关键词

backtracestringbody

翻页回溯标识，用于翻页，从上一次请求返回的响应中获取

search_idstringbody

搜索ID，用于翻页，从上一次请求返回的响应中获取

sort_typestringbody

排序方式：0=综合排序 1=最多点赞 2=最新发布

content_typestringbody

内容类型：0=不限 1=视频 2=图片 3=文章

publish_timestringbody

发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年

filter_durationstringbody

视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_video_search_v1' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"cursor":null,"keyword":"咖啡","backtrace":"demo","search_id":"demo","sort_type":"demo","content_type":"demo","publish_time":"demo","filter_duration":"demo"}'

Response

Sample captured 2026-08-27

data{

code:0

data{

data[ 2 items ]

extra{ 5 items }

cursor:8

log_pb{ 2 items }

ad_info{ 0 items }

has_more:1

backtrace:

"J6aGE6HAjYfQrWVjdpCA4koXHeq2D+xd626XetlNTOcDaD1vfAp9QZlMsoEl42R1WqHHFYJwGEfrOQ51..."

aweme_list:null

status_code:0

guide_search_words[ 2 items ]

global_doodle_config{ 1 item }

}

meta{

endpoint:"douyin.search.fetch_video_search_v1"

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.