- Overall invocation description
- Common Aggregate DataPOST
- Conditional SearchPOST
- Get Custom QualityPOST
- Network Delay DataPOST
- Get Single Match KV DataPOST
- Single Match DetailsPOST
- Device Analysis (Legacy API - For Reference Only)POST
- Scene Aggregate Data (Legacy API - For Reference Only)POST
- User Detail Data Query (Legacy API - For Reference Only)POST
Common Aggregate Data
POST
/openapi/common/aggregateData
Example script: https://perfsight-docs-1258344700.cos.ap-nanjing.myqcloud.com/open/PS_aggregateData.py
Request
Body Params application/json
Example
{
"version": [
"0.0.0.0.8627821(Publish_Marketing_Android_Dev.#185)"
],
"sceneName": [ "Misty Island"],
"isCustomize": true,
"customizeArr": [
{
"CategoryId": 5,
"CategoryItemId": 2
}
],
"country":["world"],
"aggres": ["app_version"],
"archive": "year", //all: version cycle week: weekly day: daily hour: hourly interval: interval accumulation
"stime": "2025-12-19 00:00:00",
"etime": "2025-12-19 23:59:59",
"platform": 0,
"projId": 3508,
"apmEnv": "v2",
"requestid": "20370fc56eda438daf7d139101ad188e",
"userName": "willsondang"
} Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/common/aggregateData' \
--header 'Content-Type: application/json' \
--data-raw '{
"version": [
"0.0.0.0.8627821(Publish_Marketing_Android_Dev.#185)"
],
"sceneName": [ "Misty Island"],
"isCustomize": true,
"customizeArr": [
{
"CategoryId": 5,
"CategoryItemId": 2
}
],
"country":["world"],
"aggres": ["app_version"],
"archive": "year", //all: version cycle week: weekly day: daily hour: hourly interval: interval accumulation
"stime": "2025-12-19 00:00:00",
"etime": "2025-12-19 23:59:59",
"platform": 0,
"projId": 3508,
"apmEnv": "v2",
"requestid": "20370fc56eda438daf7d139101ad188e",
"userName": "willsondang"
}'Responses
🟢200OK
application/json
Body
Example
{
"code": 200,
"data": {
"ret": [
{
"Id": 0,
"DeviceUniqueId": 0,
"CalendarTime": "2025-12-25 01:00:00",
"DeviceModel": "",
"OriginModel": "",
"Ram": 0,
"DeviceCpuCore": 0,
"Os": "",
"HarmonyOS": "",
"Osversion": 0,
"DeviceCpuFreq": 0,
"GpuRenderer": "",
"GpuVersion": "",
"DeviceManu": "",
"SceneLabel": "All",
"DefClass": 0,
"MergeCount": 3210,
"Quality": "Recommended resolution: HD",
"BenchmarkMainTop": "",
"CountryId": 0,
"CountryName": "",
"CpuAvg": 0,
"AvgOnlineTime": 0,
"CountRate": 1,
"X64Support": "Yes",
"MaxFreq": 0,
"MinFreq": 0,
"SocHardware": "",
"SocPlatform": "",
"CpuName": "",
"Version": "",
"VersionName": "",
"DisplayVersion": "0.0.0.0.8681971(Publish_Marketing_Android_Hetu_Dev_ReuseCooked.#270)",
"HpGpuVersion": "",
"SpecialRenderConf": "",
"Arch": "",
"Flashsz": 0,
"SocScore": 0,
"CpuScore": 0,
"GpuScore": 0,
"ProjVersionId": 10112340,
"TotalMergeCount": 0,
"VersionState": 0,
"VersionMark": "",
"ProjId": 3508,
"Uuid": "62c6fc99-caea-498a-a9b8-d70d4ad482d3",
"RamList": null,
"OsList": null,
"SocList": null,
"GpuList": null,
"FpsMean": 14.14,
"FpsSwingHour": 242.07,
"LowFpsHour": 902.7,
"JankFrameHour": 3764.87,
"PdSmallJank": 113.2,
"PdBigJank": 76.9,
"PdSmallJankM10": 306.44,
"PdBigJankM10": 208.16,
"Frame100": 9.03,
"CpuDeclineCount": 1,
"CpuDeclineAll": 3210,
"CpuDeclinePercent": 0.031152649,
"Stutter": 14.72,
"FpsAttainment": 0,
"UaStutter": 0,
"DroppedFrames": 0.01,
"TimeBasedLowFps": 0.1,
"FrameBasedLowFps": 0.65,
"TimeBasedLow5Fps": 0.12000000000000001,
"FrameBasedLow5Fps": 2.14,
"WpStutter": 0,
"FpsVarMean": 80.01,
"ChargePercent": 0.12,
"FpsSection1": 0,
"FpsSection2": 98.85,
"FpsSection3": 1.09,
"FpsSection4": 0.06,
"FpsSection5": 0,
"Pss": 1746.67,
"MemTopOnePercent": 2638.19,
"TopMem": 3807,
"SumPss": 5606819,
"Vss": 19295.18,
"VssMemTopOnePercent": 20659.18,
"VssTopMem": 41715,
"GreenFrameRatio": 0,
"VssTotal": 61937519,
"Mono": 0,
"TemperatureSeriousPercent": 0,
"TemperatureCriticalPercent": 0,
"CpuValidMatches": 0,
"CpuMean": 40.17,
"CurrentMean": 400.06,
"PowerMean": 1558.85,
"PowerConsumption": 66.68,
"CPUTemperatureMean": 73.06,
"BatteryTemperatureMean": 41.43,
"PowerConsumPerFrame": 0,
"CustomFrameJitter": 0,
"CustomJank": 0,
"CustomBigJank": 0,
"CustomLowFrame": 0,
"IdealJitter": 0,
"CustomSwingRelative": 0,
"CustomSwingRelativeAbs": 0,
"JankFrameHourDT": 0,
"PdSmallJankM10DT": 0,
"PdBigJankM10DT": 0,
"Frame100DT": 0,
"StutterDT": 0,
"GreenFrameRatioDT": 0,
"TopOnePercentFrameCountLowFrameDT": 0,
"TopOnePercentSceneTimeLowFrameDT": 0,
"TopFivePercentFrameCountLowFrameDT": 0,
"TopFivePercentSceneTimeLowFrameDT": 0,
"StutterJank0": 0,
"StutterJitter": 0,
"D31": 0,
"D32": 0,
"D33": 0,
"D34": 0,
"D35": 0,
"D36": 0,
"TempRiseDuration": 0,
"LoadingTime": 0,
"LoadingTimeMeanR1000": 0,
"MeanSceneTime": 222.14,
"Mark": "",
"Xcode": 1746.67,
"RealPssAvg": 1746.67,
"RealmemTotal": 5606819,
"DistData": {},
"NetTrafficIn": 61.26,
"NetTrafficOut": 9.29,
"PssPercentile1": 2638.19,
"PssPercentile10": 2116.96,
"PssPercentile20": 1977.81,
"PssPercentile50": 1736.1,
"PssPercentile90": 1569.65,
"VssPercentile1": 20659.18,
"FootprintP10": 19073.13,
"FootprintP50": 19256.89,
"FootprintP80": 19369.02,
"FootprintP90": 19468.41,
"FootprintP99": 20659.18,
"PerfData": {
"OutPacketLostCountPer10min": 0,
"InPacketLostCountPer10min": 0,
"OutPacketBlockCountPer10min": 0,
"InPacketBlockCountPer10min": 0,
"QueuedBitsPer10min": 0,
"OutPacketLostSum": 0,
"InPacketLostSum": 0,
"NtlDelayMean": 0,
"RealLostMean": 0,
"InOrderMean": 0,
"DisorderInFrameMean": 0,
"DelayIn4FramesMean": 0,
"DelayIn10FramesMean": 0,
"DelayIn18FramesMean": 0,
"AvgInBytesPerSecond": 0,
"AvgOutBytesPerSecond": 0,
"AvgInPacketSize": 0,
"AvgOutPacketSize": 0,
"AvgSaturationRate": 0,
"AvgPing": 0
},
"DeviceCount": 2,
"UserCount": 2497,
"JankCoverRate": 0,
"CustomStatdataJankCovered": 0,
"CustomStatdataJank0Covered": 0,
"CustomStatdataNotGreenCovered": 0,
"CustomNetInfoAvgRtt": 0,
"CustomNetInfoAvgQueuedBits": 0,
"CustomNetInfoAvgSkippedNum": 0,
"CustomStatdataJitterCover": 0,
"DeviceCpuUsage": 0,
"LoadInfoAvgDensityPeak": 0,
"LoadInfoAvgDensityAvg": 0,
"LoadInfoAvgAINumPeak": 0,
"LoadInfoAvgAINumAvg": 0,
"LoadInfoAvgPlayerPeak": 0,
"LoadInfoAvgPlayerAvg": 0,
"LoadInfoAvgFilteredDensityPeak": 0,
"LoadInfoAvgFilteredDensityAvg": 0,
"TimerInfoAvgTickablesTimeAvg": 0,
"TimerInfoAvgTickGroupsTimeAvg": 0,
"TimerInfoAvgTickDispatchTimeAvg": 0,
"TimerInfoAvgTickFlushTimeAvg": 0,
"LoadInfoAvgRepActorAvg": 0,
"LoadInfoAvgCompTickAvg": 0,
"LoadInfoAvgCompRepAvg": 0,
"LoadInfoAvgActorTickAvg": 0,
"LoadInfoAvgActorRepAvg": 0,
"AvgPss": 0,
"MaxUss": 0,
"AvgUss": 0,
"AvgWorkingSet": 0,
"apm_is_low_power": 0,
"apm_is_charging": 0,
"apm_is_low_freq": 0,
"apm_change_frame_rate": 0,
"apm_temperature_warning": 0,
"apm_screen": "",
"apm_network_type": "",
"apm_os_str": "",
"apm_manu": "",
"apm_disk": "",
"apm_gpu_mem": 0,
"apm_game_screen": "",
"apm_avg_cpu_user_usage": 0,
"mark": "",
"apm_gttime": 0,
"apm_rttime": 0,
"apm_idletime": 0,
"apm_temperature_light_percent": 0,
"apm_temperature_moderate_percent": 0,
"apm_temperature_critical_android_percent": 0,
"apm_temperature_server_android_percent": 0,
"apm_temperature_emergency_percent": 0,
"apm_temperature_shutdown_percent": 0,
"apm_start_cloud": 0,
"apm_windows_device_type": 0,
"apm_pixel": 0,
"apm_max_threads": 0,
"apm_server_uptime": 0,
"AbnormalMergeCount": 0,
"AbnormalUserCount": 0,
"Children": null
}
],
"retCode": 10000,
"requestid": "d8ccb0d886515f395744378c460fa5cb"
},
"flushTime": "2025-12-26 15:37:49"
}Modified at 2025-12-30 07:52:02