Docs

Application Performance Management Plus

Exceptions and crashes

GetAppPvUv

Obtain the app PV and UV.

Request description

RUM is deployed across multiple regions worldwide to provide more stable and low-latency access. You can refer to the Service addresses topic to choose the most suitable access point based on your business location.

Request method: POST

Request URL: https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppPvUv&Version=2025-12-01

Request parameters

The following table lists only the request parameters specific to this API and some public parameters. For details, see Public parameters.

tip

Before you call this API, specify the required public request parameters (such as x-app-ids). Otherwise, the call fails.

Parameters	Type	Required	Sample value	Description
Action	String	Yes	GetAppPvUv	The API name. The name of the current API is GetAppPvUv.
Version	String	Yes	2025-12-01	The API version. The API version is 2025-12-01.
StartTime	Integer	Yes	1665417600	The timestamp of the query start time. Unit: seconds.
EndTime	Integer	Yes	1665504000	The timestamp of the query end time. Unit: seconds.
Filters	Object of Condition	No	-	The filter condition.
TimeType	String	No	api_time	The time type. Values: api_time: Report time (default) event_time: Occurrence time

Condition

Parameters	Type	Required	Sample value	Description
Op	String	No	in	The operator. Values: gt: greater than gte: greater than or equal to lt: less than lte: less than or equal to eq: equal to neq: not equal to in: contains not_in: does not contain lk: Matches data that fits a specific pattern. nlk: Excludes data that fits a specific pattern.
Type	String	No	expression	The type of the filter condition. Sample value: expression: The current condition is a single expression. and: The current condition is a compound expression, and the sub-conditions in SubConditions are in a logical AND relationship. or: The current condition is a compound expression, and the sub-conditions in SubConditions are in a logical OR relationship. map: The current condition is of the map type.
Value	String	No	123456	The filter value.
MapKey	String	No	key_1	The key of the map type. tip This parameter is required when type is set to map.
Values	Array of String	No	[123456]	The filter values. You can configure multiple values simultaneously.
Dimension	String	No	aid	The name of the condition.
SubConditions	Array of Condition	No	[]	The sub-condition.

Sample request

Response parameters

Parameters	Type	Sample value	Description
Pv	Long	100	The number of times the app_launch event is reported.
Uv	Long	10	The number of unique device IDs after deduplication of PVs.

Sample response

Error codes

No error codes are specific to this API. If the API call returns an error code, refer to Public error codes for troubleshooting.

Last updated: 2026.09.16 17:52:28