# 查询实时质量 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 } ] } } ```