# 多种条件组合查询接口
# 接口描述
支持按曲风、语言、发行时间、生效时间、版权公司、艺人、艺人地区、艺人生日、艺人性别、歌曲、专辑查询相关的歌曲或者专辑。支持精准和模糊的查询。在排序上支持按热度排序、按发行时间排列最新或最老、随机排序。
# 调用方法
请求接口:/SEARCH/inSearch.json
请求方法:POST
# 输入参数
参数名 | 类型 | 是否必传 | 说明 |
---|---|---|---|
genre | string | 非必传 | 曲风标签;多个用,分隔,最多 10 个 |
language | string | 非必传 | 语言; 多个用,分隔,最多 10 个 |
relaseDataStart | string | 非必传 | 发行时间的起始时间;如 2010-1-1 |
relaseDataEnd | string | 非必传 | 发行时间的结束时间;如 2010-1-1 |
pushTimeStart | string | 非必传 | 上架时间区间的开始;如 2010-1-1 |
pushTimeEnd | string | 非必传 | 上架时间区间的结束;如 2010-1-1 |
cpId | string | 非必传 | 歌曲版权归属方 id,可同时输入多个版权作为 or 条件查询,以,分割,最多 1 次查询 50 个 |
artistName | string | 非必传 | 艺人名; matchMode=1 时支持多个,分隔,最多 100 |
artistGender | string | 非必传 | 性别;多个用,分隔。 |
值包括:男、女、组合、乐队、未知 | |||
artistBirthdayStart | string | 非必传 | 艺人生日开始时间,如 1982-1-1 |
artistBirthdayEnd | string | 非必传 | 艺人生日结束时间,如 1982-1-1 |
trackTitle | string | 非必传 | 歌曲名; matchMode=1 时支持多个,分隔,最多 100 |
albumTitle | string | 非必传 | 专辑名; matchMode=1 时支持多个,分隔,最多 100 |
matchMode | numeric | 非必传 | 查询模式:1 精准;2 模糊 |
sortMode | numeric | 非必传 | 排序方式:1 热度;2 最老;3 最新;4 随机 |
(只在 matchMode=1 工作) | |||
pageNo | numeric | 必传 | 页数;值只能为[1,50] |
pageSize | numeric | 必传 | 每页数量;值范围[1,100] |
searchType | numeric | 必传 | 搜索对象:1 歌曲;2 专辑 |
# 返回结果
查询结果为歌曲
{
"state": true,
"errcode": "",
"errmsg": "",
"data": {
"total": 557637,
"result": [
{
"artist": [
{
"artistCode": "A10048162",
"birthday": "1983-08-31",
"gender": "男",
"name": "大张伟",
"artistType": 38,
"artistTypeName": "歌手",
"pic": "https://img01.dmhmusic.com/0206/M00/70/D9/ChR461tM64yARSFhAADEOxmuddA496.jpg",
"region": "内地"
}
],
"cpId": 23,
"pic": "https://img01.dmhmusic.com/0412/M00/00/7E/ChAKEV_JGxKAf3ZnADa7gUndFt8345.jpg",
"title": "我怎么这么好看!",
"duration": 175,
"assetId": "T10052961771",
"genre": "流行",
"albumTitle": "20是件更美好的事",
"id": "T10052961771",
"lang": "中文",
"afReplayGain": -3.739998,
"albumAssetCode": "P10003127083",
"releaseDate": "2019-12-19T10:00:00.000Z",
"trail_audio_info": {
"duration": "30",
"start_time": "0",
"path": "http://audio04.dmhmusic.com/71_53_T10052961771_128_4_4_0_sdk-cpm/cn/0104/M00/0B/4A/ChR45V8ahvmAQ3OHAAdXW-_yrTI274.mp3?xcode=cff1196ad08e9122766f95bc5d11d4ba5499d17",
"rate": 128,
"expireTime": 1607417789
},
"isrc": "CN-Z50-19-01596",
"sort": 3,
"meanVolume": -10.1,
"maxVolume": 0,
"lyric": "https://static01.dmhmusic.com/0412/M00/00/7E/ChAKEV_JGxGAG4ToAAAMD1U4Jxo669.lrc",
"pay_model": 3,
"_trackId": 17124192,
"TSID": "T10052961771",
"allRate": ["64", "320", "128", "3000"],
"pushTime": "2019-12-23T02:00:00+00:00",
"downTime": "2036-12-31T16:00:00+00:00",
"bizList": ["sdk_cpm"],
"rateFileInfo": {
"64": {
"size": 1406948,
"format": "aac"
},
"128": {
"size": 2812491,
"format": "mp3"
},
"320": {
"size": 7031162,
"format": "mp3"
},
"3000": {
"size": 23651290,
"format": "flac"
}
}
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
查询结果为专辑
{
"state": true,
"errcode": "",
"errmsg": "",
"data": {
"total": 120498,
"result": [
{
"albumAssetCode": "P10003127083",
"artist": [
{
"artistCode": "A10048162",
"birthday": "1983-08-31",
"gender": "男",
"name": "大张伟",
"artistType": 38,
"artistTypeName": "歌手",
"pic": "https://img01.dmhmusic.com/0206/M00/70/D9/ChR461tM64yARSFhAADEOxmuddA496.jpg",
"region": "内地"
}
],
"releaseDate": "2019-12-19T10:00:00.000Z",
"cpId": 23,
"introduce": "《20是件更美好的事》专辑介绍 《20是件更美好的事》是大张伟出道2......",
"genre": "流行",
"upc": "6972818350407",
"pic": "https://img01.dmhmusic.com/0412/M00/00/7E/ChAKEV_JGxKAf3ZnADa7gUndFt8345.jpg",
"type": 1,
"title": "20是件更美好的事",
"lang": "中文",
"pushTime": "2019-12-23T02:00:00+00:00",
"downTime": "2036-12-31T16:00:00+00:00",
"available": true,
"availableErrMsg": ""
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38