搜索音频
通过音频id、关键词或其他筛选条件获取新音频id结果集合及排序序列
接口地址(URI):/api/music/search
HTTP请求方式:GET
请求参数:
请求值字段 | 必选 | 类型 | 说明 |
---|---|---|---|
id | false | string | 音频编号 |
keyword | true | string | 关键词搜索。支持多关键词搜索,and条件。多关键词用空格分隔 |
sort_by | false | string | 排序方式:正序、倒序,输入:asc/desc |
has_vocal | false | integer | 是否人声,1-是 2-否 |
duration | false | string | 时长.单位为秒 . 使用区间来获取,例:12,50(筛选12-50秒的音乐) |
music_type | false | integer | 1-音乐 2-音效 |
bpm | false | string | Beat Per Minute的简称,音乐节拍数,释义为每分钟节拍数。 使用区间来获取,例:80,100(筛选节拍为80-100的音乐) |
page | false | integer | 第几页,仅支持输入数字. 默认值1. |
nums | false | integer | 每页返回数量 最小值1. 最大值100. 默认值100. |
返回参数:
返回字段 | 说明 |
---|---|
res_id | 音频编号 |
title | 标题 |
artist | 艺术家 |
duration | 时长,单位为秒 |
bpm | Beat Per Minute |
album_cover_url | 封面图地址 |
preview_jpg_json_https | 音频预览波形图数据(https) |
preview_url_https | 预览小样下载地址 https 地址 |
keywords | 关键词 |
total_count | 返回结果总数 |
total_page | 返回结果总页数 |
per_page | 每页结果总数 |
cur_page | 当前页码 |
请求参数示例example value:
Curl: curl -X GET --header 'Accept: application/json' --header 'api-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' --header 'authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxx 'https://api.fotomore.com/api/music/search?keyword=test&nums=2' Request URL: https://api.fotomore.com/api/music/search?keyword=test&nums=2
返回数据示例example value:
{ "status_code": 1, "message": "ok", "data": { "list": [ { "res_id": "VCG231159049", "title": "Failed the Test", "artist": "Toby Tranter", "duration": 172, "bpm": 158, "preview_url_https": "https://music-static-api.fotomore.com/music/preview/VCG231159049.mp3?uid=33×tamp=1677747207&sign=9d62fed4d7bcc427b711e0c735280ac5", "album_cover_url_https": "https://music-static-api.fotomore.com/music/album_cover_800/53367.jpg", "preview_jpg_json_https": "https://music-static-api.fotomore.com/music/wave/VCG231159049.json", "keywords": "" }, { "res_id": "VCG231158706", "title": "Nowhere to Be Found", "artist": "Philip Ayers", "duration": 130, "bpm": 140, "preview_url_https": "https://music-static-api.fotomore.com/music/preview/VCG231158706.mp3?uid=33×tamp=1677747207&sign=9d62fed4d7bcc427b711e0c735280ac5", "album_cover_url_https": "https://music-static-api.fotomore.com/music/album_cover_800/53307.jpg", "preview_jpg_json_https": "https://music-static-api.fotomore.com/music/wave/VCG231158706.json", "keywords": "考试,测验,测试,线索,琐事,计时,紧急" } ], "total_count": 24, "total_page": 12, "per_page": 2, "cur_page": 1 } }