查询合唱榜单

正式环境

https://api.kg.qq.com

POST

/karaoke/oper/v2/get_tv_chorus_toplist

查询合唱榜。非频道榜应用按 song_mid 查询歌曲维度榜单；频道榜应用按 AppID 查询频道榜与 TV 榜合并后的结果，song_mid 在该场景不参与查询。need_all=false 时仅返回榜首和榜尾各一条记录；两者为同一名次时只返回一条。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "song_mid": "000YbhEa1dFhgt",
    "need_all": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.kg.qq.com/karaoke/oper/v2/get_tv_chorus_toplist' \
--header 'X-Open-Access-Token: ' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID: ' \
--header 'Client-IP: 103.13.31.139' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data '{
    "song_mid": "000YbhEa1dFhgt",
    "need_all": false
}'

返回响应

🟢200OK

application/json

请求已处理；业务错误通过 code、msg 返回。

Bodyapplication/json

示例

{
    "code": 0,
    "sub_code": 0,
    "msg": "请求成功",
    "data": {
        "vec_chorus": [
            {
                "score": 25518754,
                "pos": 1,
                "song_name": "示例歌曲",
                "vec_chorus_user": [
                    {
                        "user_id": "2185173999",
                        "appid": "100120",
                        "user_type": 0,
                        "user_avatar": "https://example.com/avatar.jpg",
                        "user_nick": "示例用户"
                    }
                ]
            }
        ]
    }
}

修改于 2026-09-23 12:09:45

获取渠道运营位配置

上报合唱榜单