获取音乐搜索

stable · 13 credits / 次（成功才计）

获取抖音 App 中音乐内容的搜索结果。；支持关键词、排序方式、筛选条件等。；备注；本接口专注于音乐类内容搜索，不包含其他类型内容。；初次请求时 `cursor` 传 0，`search_id` 传空字符串。；返回内容包含音乐基本信息、作者信息、封面、播放地址、标签等。；keyword: 搜索关键词，例如 "游戏背景音乐"；cursor: 翻页游标（首次请求传 0，翻页时使用上次响应的 cursor）；sort_type: 排序方式；- `0`: 综合排序；- `1`: 最多点赞；- `2`: 最新发布；publish_time: 发布时间筛选；- `0`: 不限；- `1`: 最近一天；- `7`: 最近一周；- `180`: 最近半年；filter_duration: 视频时长筛选；- `0-1`: 1 分钟以内；- `1-5`: 1-5 分钟；- `5-10000`: 5 分钟以上…

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_music_search' \ -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"}'

POST /v1/douyin/search/fetch_music_search

获取音乐搜索

stable · 13 credits / 次（成功才计）

请求参数

参数	类型	位置	必填	说明	示例
cursor	integer	body	否	偏移游标，用于翻页，从上一次请求返回的响应中获取	demo
keyword	string	body	否	关键词	咖啡
backtrace	string	body	否	翻页回溯标识，用于翻页，从上一次请求返回的响应中获取	demo
search_id	string	body	否	搜索ID，用于翻页，从上一次请求返回的响应中获取	demo
sort_type	string	body	否	排序方式：0=综合排序 1=最多点赞 2=最新发布	demo
content_type	string	body	否	内容类型：0=不限 1=视频 2=图片 3=文章	demo
publish_time	string	body	否	发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年	demo
filter_duration	string	body	否	视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上	demo

响应字段

字段字典待补 —— 右侧可执行区可直接看到真实结构。

错误码

code	HTTP	含义	是否计费
40001	400	参数缺失或格式错误	否
40102	401	API Key 无效或已吊销	否
40201	402	余额不足，请充值	否
40402	404	目标资源不存在	否
42201	422	质量门槛未通过	否
42901	429	超出速率限制	否
50401	504	上游超时	否
50201	502	上游返回异常	否

计费

成功扣 13 credits；任何失败（含上游 200 但未过质量门槛）扣 0。