# 查询实时规模 (/zh-CN/api-reference/api-ref/agora-analytics/realtime-usage)

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

获取实时的通话人数和频道数。

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

## Servers

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

## Authorization

This endpoint requires authentication.

- `Authorization`

## Parameters

- `startTs` (query, required, number) - 查询的时间范围起点，Unix 时间戳（秒）。响应中会包含起点所在的时间窗口。
- `endTs` (query, required, number) - 查询的时间范围终点，Unix 时间戳（秒）。响应中不会包含终点所在的时间窗口。
- `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) - 要查询的指标，支持设为以下值：
- `userCount`：通话人数，一个用户 ID 在一个频道中计为一人，在多个频道中计为多人。
- `channelCount`：频道数，从有用户加入频道到所有用户离开频道计为一个通话频道。
- `dimension` (query, optional) - 统计维度，仅支持单维度指定。仅在 `metric` 为 `userCount` 时生效。支持设为以下值：
- `country`：国家。
- `region`：地区。
- `net`：网络类型。
- `sdk`：SDK 版本。
- `os`：操作系统。
- `device`：设备型号。 你可以通过[获取实时规模 TOP 20 分组](realtime-usage-top20)获取当前 `dimension` 下的 TOP 值，再根据业务需要从中选取几个值，来作为下次请求时传入 `dimensionValues` 的值。
- `dimensionValues` (query, optional) - 统计维度的值 ，即对 `dimension` 中设定的维度指定取值，仅在传入 `dimension` 时有效。所有值必须用双引号包括，并以逗号分隔。
- `cname` (query, optional, string) - 频道名称。如果不填，代表查询该项目的整体指标。

## 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": [
    {
      "userCount": 236,
      "sdk": "3.6.1.1",
      "ts": 1631837400
    },
    {
      "userCount": 82,
      "sdk": "4.1.1",
      "ts": 1631837400
    },
    {
      "userCount": 235,
      "sdk": "3.6.1.1",
      "ts": 1631837420
    },
    {
      "userCount": 85,
      "sdk": "4.1.1",
      "ts": 1631837420
    },
    {
      "userCount": 252,
      "sdk": "3.6.1.1",
      "ts": 1631837440
    },
    {
      "userCount": 90,
      "sdk": "4.1.1",
      "ts": 1631837440
    }
  ]
}
```