# 查询实时质量 TOP 20 分组 (/zh-CN/api-reference/api-ref/agora-analytics/realtime-quality-top20)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

获取指定维度下实时质量指标排名前 20 的分组数据。

- OpenAPI: /openapi/agora-analytics/analytics-rest-api.zh-CN.yaml
- Operation ID: get-beta-realtime-quality-dimension-top20
- Method: GET
- Path: /beta/realtime/quality/dimension/top20
- Endpoint: https://api.sd-rtn.com/beta/realtime/quality/dimension/top20

## Servers

- https://api.sd-rtn.com

该接口可为[查询实时质量](realtime-quality)接口的 `dimensionValues` 参数提供内容输入。


## Authorization

This endpoint requires authentication.

- `Authorization`

## Parameters

- `ts` (query, required, number) - 查询的时间范围起点，Unix 时间戳（秒）。实际查询范围为 [`ts`, `ts` + 20s ]。
- `appid` (query, required, string) - 你的项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。
- `productType` (query, required, string) - 要查询的产品类型，支持设为以下值：
- `Native`：指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。
- `WebRTC`：指 Web 平台的声网 RTC SDK。
- `metric` (query, required, string) - 要查询的指标，支持设为以下值：
- `joinSuccessRate`：加入频道成功率。
- `joinSuccessIn5sRate`：5s 内加入频道成功率。
- `audioFreezeRate`：音频卡顿率。
- `videoFreezeRate`：视频卡顿率。
- `networkDelay` ：网络延迟率。
- `dimension` (query, required, string) - 统计维度，仅支持单维度指定。支持设为以下值：
- `country`：国家。
- `region`：地区。
- `net`：网络类型。
- `sdk`：SDK 版本。
- `os`：操作系统。
- `device`：设备型号。将默认返回维度对应 TOP 20 的值（仅当 `dimension` 为 `device` 时，将默认返回 TOP 50 的值）。
- `extraMetrics` (query, optional, string) - 额外指标，用于辅助判断数据的有效性。仅支持设为 `userCount`，即当前维度下的用户数。

## Request body

No request body.

## Responses

### 200

OK

- `code` (number) - 响应状态码。200 表示请求成功，详见[响应状态码](/zh-CN/realtime-media/usage-analytics/reference/response-code)。
- `message` (string) - 错误消息。
- `data` (array) - 由维度、指标数据和时间窗口的起止 Unix 时间戳（秒）组成的数组。
  - `data.items` (object)

## Response examples

### 200

```json
{
  "code": 200,
  "message": null,
  "data": {
    "list": [
      {
        "audioFreezeRate": 0.050833333333333335,
        "windowStartTs": 1671624000,
        "userCount": 2,
        "device": "ldn-al00",
        "windowEndTs": 1671624020
      },
      {
        "audioFreezeRate": 0,
        "windowStartTs": 1671624000,
        "userCount": 2,
        "device": "80HH",
        "windowEndTs": 1671624020
      },
      {
        "audioFreezeRate": 0,
        "windowStartTs": 1671624000,
        "userCount": 1,
        "device": "20KNA004CD",
        "windowEndTs": 1671624020
      }
    ]
  }
}
```