# 查询主播列表 (/zh-CN/api-reference/api-ref/rtc/query-host-list) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 查询直播场景下指定频道内的主播列表。 - OpenAPI: /openapi/rtc/channel-management.zh-CN.yaml - Operation ID: get-dev-v1-channel-user-appid-channelName-hosts_only - Method: GET - Path: /dev/v1/channel/user/{appid}/{channelName}/hosts_only - Endpoint: https://api.sd-rtn.com/dev/v1/channel/user/{appid}/{channelName}/hosts_only ## Servers - https://api.sd-rtn.com :::info[注意] - 该 API 仅限在直播场景(`mode` 的值为 `2`)下使用。 - 同一频道内的用户必须使用相同的频道场景。否则,查询结果可能不准确。 - 该 API 和[查询用户状态 API](query-user-status) 均能用于同步在线频道状态信息。相比于查询用户状态 API,该 API 所需的调用频率低,查询效率高。因此,声网更推荐使用该 API 查询用户状态。 ::: ## Authorization This endpoint requires authentication. - `Basic Auth` ## Parameters - `appid` (path, required) - 项目的 App ID。可通过以下方式获取: - 从声网控制台获取。 - 调用[获取所有项目信息 API](/zh-CN/api-reference/api-ref/console/list-projects),并读取响应包体中 `vendor_key` 字段的值。 - `channelName` (path, required) - 频道名称。 ## Request body No request body. ## Responses ### 200 如果状态码为 200,则请求成功。 - `success` (boolean) - 本次请求的状态: - `true`:请求成功 - `false`:预留 - `data` (object) - `data.channel_exist` (boolean) - 指定频道是否存在: - `true`:存在 - `false`:不存在 注意:当 `channel_exist` 的值为 `false` 时,不会返回其它字段。 - `data.mode` (number) - 频道场景: - `1`:通信场景 - `2`:直播场景 - `data.broadcasters` (array) - 频道内所有主播的用户 ID。该字段仅在直播场景(`mode` 的值为 `2`)下返回。 ### 非 200 如果状态码不为 200,则请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/rtc/reference/response-code)排查问题。 No schema. ## Response examples ### 200 ```json { "success": true, "data": { "channel_exist": true, "mode": 2, "broadcasters": [ 574332, 1347839 ] } } ```