メインコンテンツまでスキップ

性能排行

您可以通过 Aptoide Connect 开发者控制台或以编程方式通过此 API 端点访问应用的性能排行。

端点​

方法URL
GEThttps://ws.catappult.io/api/applications/{applicationName}/statistics/top

身份验证​

要访问此 API,您需要在 Aptoide Connect 上拥有有效的帐户订阅,并使用 API 密钥进行身份验证(请查看此处了解如何生成密钥)。

⚠️
所需帐户类型

只有 Developer 类型的帐户才能获取性能数据。

请求头​

请求头类型是否必需说明
Api-Keystring必需用于对您的 API 请求进行身份验证。该值是您的 Aptoide Connect API 密钥。

路径参数​

参数类型说明
applicationNamestring应用的唯一包名(例如 com.example.test)。

查询参数​

参数类型是否必需说明
typestring (YYYY-MM-DD)必需按类型筛选数据。可选值:revenue、installs 或 downloads。
fromstring (YYYY-MM-DD)必需检索统计数据的时间范围开始日期。不得早于当前日期之前 6 个月。示例:2025-11-01。
tostring (YYYY-MM-DD)必需检索统计数据的时间范围结束日期。from 与 to 之间的跨度不得超过 120 天。示例:2025-11-30。
groupBystring必需按指定字段聚合结果。可选值:country 或 partner。
limitnumber可选(默认:50)响应中返回的最大记录数。
offsetnumber可选(默认:0)分页偏移量,表示数据集中的起始位置。
countryCodesstring可选使用 ISO 3166-1 alpha-2 代码按一个或多个国家/地区筛选。多个代码之间需以逗号分隔。示例:PT,US。
partnerAccountUidsstring可选按一个或多个合作伙伴帐户 UID 筛选。多个 UID 之间需以逗号分隔。合作伙伴列表请见此处。示例:b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。
amountTypestring可选(默认:wallet)指定返回净收入还是总收入。仅在 type 为 revenue 时适用。可选值:wallet(净额)或 global(总额)。
⚠️
最大时间窗口

单次请求最多覆盖 120 天,且 from 不得早于今天之前 6 个月。

如需更长的时间段,请改用性能报表(CSV)端点:它会为每份月度报表返回一个 downloadUrl,因此您无需拆分成多个排行请求即可覆盖任意时间跨度。

响应​

成功​

如果 API 调用返回 HTTP 200 状态码,则表示请求成功,并返回一个聚合统计对象数组。

响应示例​

类型: revenue;分组方式: country

[
{
"arppu": 30824.000961928934,
"arpt": 5535.394885597083,
"identifiers": {
"country": {
"code": "PT"
}
},
"transactions": 5485,
"users": 985,
"volume": 30361640.9475,
"volumeInUsd": 30361640.9475
},
{
"arppu": 15000.246,
"arpt": 10714.461428571429,
"identifiers": {
"country": {
"code": "IT"
}
},
"transactions": 7,
"users": 5,
"volume": 75001.23,
"volumeInUsd": 75001.23
},
{
"arppu": 10410.82875,
"arpt": 1487.26125,
"identifiers": {
"country": {
"code": "IS"
}
},
"transactions": 28,
"users": 4,
"volume": 41643.315,
"volumeInUsd": 41643.315
},
{
"arppu": 1397.8051296296296,
"arpt": 159.91838347457627,
"identifiers": {
"country": {
"code": "US"
}
},
"transactions": 236,
"users": 27,
"volume": 37740.7385,
"volumeInUsd": 37740.7385
}
]

类型: revenue;分组方式: partner

[
{
"arppu": 1270080.2173958332,
"arpt": 183626.05552710843,
"identifiers": {
"store": {
"account": {
"name": "storeName",
"uid": "storeUid"
}
}
},
"transactions": 166,
"users": 24,
"volume": 30481925.2175,
"volumeInUsd": 30481925.2175
},
{
"arppu": 15.649709677419354,
"arpt": 1.1775266990291262,
"identifiers": {
"store": {
"account": {
"name": "storeName",
"uid": "storeUid"
}
}
},
"transactions": 412,
"users": 31,
"volume": 485.141,
"volumeInUsd": 485.141
}
]

类型: downloads;分组方式: country

[
{
"identifiers": {
"country": {
"code": "US"
}
},
"total": 1100
},
{
"identifiers": {
"country": {
"code": "NL"
}
},
"total": 500
},
{
"identifiers": {
"country": {
"code": "PT"
}
},
"total": 190
}
]

类型: downloads;分组方式: partner

[
{
"identifiers": {
"store": {
"account": {
"name": "accountName",
"uid": "accountUid"
}
}
},
"total": 1710
},
{
"identifiers": {
"store": {
"account": {
"name": "accountName",
"uid": "accountUid"
}
}
},
"total": 80
}
]