Get Business Quality

Description

This interface can be used to query the real-time audio-video quality indicators within a specified time period, including stutter rate, first frame time, push stream success rate, pull stream success rate, room login success rate, and 5-second room login success rate.

Note

The query time period is consistent with the Data Storage and Query effective period in the package you purchased. For details, please refer to Pricing - Package Function.

Request method and endpoint

Request method: GET
Request URL: https://analytics-api.zego.im/?Action=GetBizQuality
Transfer protocol: HTTPS
QPS limit (same AppID): 3 times/minute, 480 times/day

Request parameters

The following request parameter list only lists the interface request parameters and some common parameters. Please refer to Accessing Server APIs - Public Request Parameters for the complete common parameter list.

Parameter	Type	Required	Description
StartDate	String	Yes	The start date of the query, the format must be a string format of yyyyMMdd. Note When used with `EndDate`, the date range formed by the two does not exceed the Data Storage and Query effective period in the package you purchased. For details, please refer to Pricing - Package Function.
EndDate	String	Yes	The end date of the query, the format must be a string format of yyyyMMdd.
Metrics[]	Array of String	Yes	The metrics to be queried, supported strings: break_rate: Stutter rate. fft: First frame time, in milliseconds. login_consumed: Login time, in milliseconds. publish_success_rate_cdn: CDN push stream success rate. publish_success_rate_rtc: RTC push stream success rate. play_success_rate_cdn: CDN pull stream success rate. play_success_rate_l3: L3 pull stream success rate. play_success_rate_rtc: RTC pull stream success rate. login_success_rate: Room login success rate. login_success_5s: Login success rate in 5 seconds.

Request Example

https://analytics-api.zego.im/?Action=GetBizQuality
&StartDate=20250110
&EndDate=20250112
&Metrics[]=fft
&<Public Request Parameters>

https://analytics-api.zego.im/?Action=GetBizQuality
&StartDate=20250110
&EndDate=20250112
&Metrics[]=fft
&<Public Request Parameters>

Response Parameters

Parameter	Type	Description
Code	Number	Return code.
Message	String	Operation result description.
RequestId	String	Request ID.
Data	Array	Response data.
└Metrics	Array of Object	Metric list.
└Metric	String	Metric name.
└Values	Array of Object	Metric value list.
└Date	String	Date, format as "yyyyMMdd".
└Value	Number	Metric value.

Response Example

{
    "Code": 0,
    "Data": {
        "Metrics": [
            {
                "Metric": "fft",
                "Values": [
                    {
                        "Date": "20250110",
                        "Value": 60
                    },
                    {
                        "Date": "20250111",
                        "Value": 20
                    },
                    {
                        "Date": "20250112",
                        "Value": 10
                    }
                ]
            }
        ]
    },
    "Message": "success",
    "RequestId": 1659512998878671000
}

{
    "Code": 0,
    "Data": {
        "Metrics": [
            {
                "Metric": "fft",
                "Values": [
                    {
                        "Date": "20250110",
                        "Value": 60
                    },
                    {
                        "Date": "20250111",
                        "Value": 20
                    },
                    {
                        "Date": "20250112",
                        "Value": 10
                    }
                ]
            }
        ]
    },
    "Message": "success",
    "RequestId": 1659512998878671000
}

Return Code

Return Code	Description	Action
0	Success.	-
500	Interface error.	Contact ZEGOCLOUD Technical Support.
10001	Parameter format error.	Check parameters.
10002	Parameter error or parameter invalid.	Check parameters.
30002	Interface request frequency exceeds the limit.	Please confirm the QPS limit of the corresponding interface and reduce the request frequency.