搜索多版权方的歌曲

---

1 描述

通过输入关键词搜索歌曲，同时在多家版权方曲库中搜索查询，支持对搜索结果筛选、排序等。搜索结果包含歌曲信息、歌手信息、歌曲所属专辑信息、版权信息、以及是否有伴奏等。

2 接口原型

• 请求方法：GET
• 请求地址：https://ktv-api.zego.im/?Action=QuerySongPlus
• 传输协议：HTTPS
• 调用频率限制：200 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 - 公共请求参数。

4 请求示例

https://ktv-api.zego.im/?Action=QuerySongPlus
&Keyword=我和我的祖国
&Page=1
&Filter[]=1
&VendorsId[]=1
&VendorsId[]=2
&KeepVendor=1
&Items[]=1
&Items[]=2
&<公共请求参数>

5 响应参数

其中参数 Data：

其中参数 Songs：

其中参数 Copyright：

6 响应示例

{
    "Code": 0,
    "Message": "succeed",
    "RequestId": "1a6d02a8-66ba-455f-9e05-fe77da6a1f14",
    "Data": {
        "Songs": [
            {
                "SingerImg": "http://xxx.xxx.xxx/uploadpic/softhead/150/20210506/20210506171823975.jpg",
                "AlbumId": "123",
                "AlbumImg": "http://xxx.xxx.xxx/stdmusic/150/20150719/20150719001841825066.jpg",
                "AlbumImgMini": "http://xxx.xxx.xxx/stdmusic/150/20150719/20150719001841825066.jpg",
                "AlbumImgSmall": "http://xxx.xxx.xxx/stdmusic/240/20150719/20150719001841825066.jpg",
                "AlbumImgMedium": "http://xxx.xxx.xxx/stdmusic/480/20150719/20150719001841825066.jpg",
                "SongId": "40282741",
                "SongName": "我和我的祖国",
                "SingerId": "2345",
                "SingerName": "韩红",
                "AlbumName": "红歌②",
                "Duration": 250000,
                "VendorId": 2,  // 歌曲的版权方。版权方的详细信息，请联系 ZEGO 商务人员咨询
                "PitchAbility": 1, //仅当 VendorId 为 2 时，才会返回此字段
                "HasShortSegment": 1, //仅当 VendorId 为 2 时，才会返回此字段
                "Copyright": {
                    "SongLyric": 0,
                    "Recording": 1,
                    "Channel": 0
                }
            }
        ]
    }
}

7 返回码

以下仅列出了接口业务逻辑相关的部分返回码，完整返回码请参考 全局返回码。