WellbyteWellbyte

POST /v1/douyin/search/fetch_video_search_v3

Fetch video search V3

stable · 13 credits per success

Search videos by keyword (V3), with 3-dimensional filters: publish date, video type, duration.；Besides basic video info, results carry operational metrics such as play count, like count and；author follower count — useful for content research and competitor analysis.；Notes；Pagination is not supported; it returns one batch of results for the current filters.；All three filters are optional; leaving …

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

Request

querystringbody

搜索关键词

date_typeintegerbody

发布时间筛选：0=不限, 3=近3天, 7=近7天, 30=近一个月

label_typeintegerbody

视频类型筛选：0=不限, 1=低粉爆款, 2=高完播率, 3=高涨粉率, 4=高点赞率

duration_typeintegerbody

时长筛选：0=不限, 1=0-15秒, 6=15-60秒, 7=60-120秒, 8=120-180秒, 9=大于180秒

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_video_search_v3' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"query":"demo","date_type":null,"label_type":null,"duration_type":null}'

Response

Sample captured 2026-08-27

data{

code:0

data[

0{ 15 items }

1:"…共 1000 项"

]

meta{

endpoint:"douyin.search.fetch_video_search_v3"

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_v3

Fetch video search V3

stable · 13 credits per success

Search videos by keyword (V3), with 3-dimensional filters: publish date, video type, duration.；Besides basic video info, results carry operational metrics such as play count, like count and；author follower count — useful for content research and competitor analysis.；Notes；Pagination is not supported; it returns one batch of results for the current filters.；All three filters are optional; leaving …

Request parameters

Name	Type	In	Required	Description	Example
query	string	body	no	搜索关键词	demo
date_type	integer	body	no	发布时间筛选：0=不限, 3=近3天, 7=近7天, 30=近一个月	demo
label_type	integer	body	no	视频类型筛选：0=不限, 1=低粉爆款, 2=高完播率, 3=高涨粉率, 4=高点赞率	demo
duration_type	integer	body	no	时长筛选：0=不限, 1=0-15秒, 6=15-60秒, 7=60-120秒, 8=120-180秒, 9=大于180秒	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

querystringbody

搜索关键词

date_typeintegerbody

发布时间筛选：0=不限, 3=近3天, 7=近7天, 30=近一个月

label_typeintegerbody

视频类型筛选：0=不限, 1=低粉爆款, 2=高完播率, 3=高涨粉率, 4=高点赞率

duration_typeintegerbody

时长筛选：0=不限, 1=0-15秒, 6=15-60秒, 7=60-120秒, 8=120-180秒, 9=大于180秒

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_video_search_v3' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"query":"demo","date_type":null,"label_type":null,"duration_type":null}'

Response

Sample captured 2026-08-27

data{

code:0

data[

0{ 15 items }

1:"…共 1000 项"

]

meta{

endpoint:"douyin.search.fetch_video_search_v3"

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.