# 查询主播列表 (/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
    ]
  }
}
```