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

パフォーマンスランキング

アプリケーションのパフォーマンスランキングには、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)必須統計を取得する期間の終了日。例: 2025-11-30。
groupBystring必須指定したフィールドで結果を集計します。指定可能な値: country または partner。
limitnumber任意（デフォルト: 50）レスポンスで返すレコードの最大数。
offsetnumber任意（デフォルト: 0）ページネーションのオフセット。データセット内の開始位置を示します。
countryCodesstring任意ISO 3166-1 alpha-2 コードを使用して 1 つ以上の国でフィルタリングします。複数のコードはカンマで区切る必要があります。例: PT,US。
partnerAccountUidsstring任意1 つ以上のパートナーアカウント UID でフィルタリングします。複数の UID はカンマで区切る必要があります。パートナーリストはこちらを参照してください。例: b25f95eb-5da9-43a6-b24a-9096c7ecfcb8。
amountTypestring任意（デフォルト: 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
    }
]