性能排行
您可以通过 Aptoide Connect 开发者控制台或以编程方式通过此 API 端点访问应用的性能排行。
端点
| 方法 | URL |
|---|---|
| GET | https://ws.catappult.io/api/applications/{applicationName}/statistics/top |
身份验证
要访问此 API,您需要在 Aptoide Connect 上拥有有效的帐户订阅,并使用 API 密钥进行身份验证(请查看此处了解如何生成密钥)。
⚠️
所需帐户类型
只有 Developer 类型的帐户才能获取性能数据。
请求头
| 请求头 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
Api-Key | string | 必需 | 用于对您的 API 请求进行身份验证。该值是您的 Aptoide Connect API 密钥。 |
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
applicationName | string | 应用的唯一包名(例如 com.example.test)。 |
查询参数
| 参数 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
type | string (YYYY-MM-DD) | 必需 | 按类型筛选数据。可选值:revenue、installs 或 downloads。 |
from | string (YYYY-MM-DD) | 必需 | 检索统计数据的时间范围开始日期。不得早于当前日期之前 6 个月。示例:2025-11-01。 |
to | string (YYYY-MM-DD) | 必需 | 检索统计数据的时间范围结束日期。from 与 to 之间的跨度不得超过 120 天。示例:2025-11-30。 |
groupBy | string | 必需 | 按指定字段聚合结果。可选值:country 或 partner。 |
limit | number | 可选(默认:50) | 响应中返回的最大记录数。 |
offset | number | 可选(默认:0) | 分页偏移量,表示数据集中的起始位置。 |
countryCodes | string | 可选 | 使用 ISO 3166-1 alpha-2 代码按一个或多个国家/地区筛选。多个代码之间需以逗号分隔。示例:PT,US。 |
partnerAccountUids | string | 可选 | 按一个或多个合作伙伴帐户 UID 筛选。多个 UID 之间需以逗号分隔。合作伙伴列表请见此处。示例:b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。 |
amountType | string | 可选(默认: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
}
]