表现排名

您可以通过 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)	必填	检索统计数据的时间范围的结束日期。示例：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（总值）。

响应

成功

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

响应示例

Type: revenue; Group By: 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
    }
]

Type: revenue; Group By: 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
    }
]

Type: downloads; Group By: country

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

Type: downloads; Group By: partner

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