Stores API

If you are an Android distribution channel (App Store, OEM or other), you can distribute Catappult's content and benefit from our appealing revenue share for in-app purchases. Get to know more about our offering.

To join Catappult, you must create a store account and connect to Catappult's API.

List of endpoints:

Endpoints

Get a list of apps available to download

https://ws75.catappult.io/api/7/catappult/apps/get

For the next page, pass offset equal to next as an argument.
https://ws75.catappult.io/api/7/catappult/apps/get?offset=25

Results can be sorted by revenue and country
https://ws75.catappult.io/api/7/catappult/apps/get?sort=revenue30d&sort_country=PT

Available params:

- language:
    - default: 'en'
    - properties
        - min length = 2
        - max length = 6
    - example: 'pt_PT'
- limit
    - default: 25
    - example: 15
- offset
    - default: 0
    - example: 25
- order
    - default: 'en'
    - properties
        - allowed values: "ASC", "DESC", "RAND"
        - uppercase
    - example: 'ASC'
- sort
    - default: 'latest'
    - properties
        - wildcards matches: "latest", "added", "updated", "downloads*", "pdownloads*", "trending+", "rating", "alpha", "sort:+", "appc_pdownloads*", "appc_billing_pdownloads*", "revenue+"
        - max length: 128
    - example: 'downloads'
- sort_country
    - default: null
    - properties
        - ISO 3166-1 alpha-2 standard
        - only works when sorting by revenue
    - example: 'PT'

Some notes on params:
downloads* means it can have a suffix, so downloads is valid
revenue+ means it must have a suffix, so revenue is invalid
suffixes have the format [1..99] d ('days') ex: revenue30d

Get metadata for a given app

https://ws75.catappult.io/api/7/catappult/app/getMeta?package_name=com.igg.android.lordsmobile

Available params:

- app_id
    - default: null
    - example: 7306243
- language:
    - default: 'en'
    - properties
        - min length = 2
        - max length = 6
    - example: 'pt_PT'
- package_name
    - default: null
    - example: 'com.igg.android.lordsmobile'

Search for an app

https://ws75.catappult.io/api/7/catappult/apps/search?query=lordsmobile

Available params:

- language:
    - default: 'en'
    - properties
        - min length = 2
        - max length = 6
    - example: 'pt_PT'
- limit
    - default: 25
    - example: 15
- offset
    - default: 0
    - example: 25
- query
    - default: null
    - properties
        - min length = 2
        - max length = 100
    - example: 'lordsmobile'

Get updates for a given app

https://ws75.catappult.io/api/7/catappult/apps/getUpdates

Available params:

- apks_data
    - default: []
    - properties
        - truncate
        - max length: 100
        - input (KEYPAIRS):
            - required keys: "package", "vercode", "signature"
    - example: [
                  {
                    "package": "com.igg.android.lordsmobile",
                    "vercode": 30336,
                    "signature": "D5:90:A7:D7:92:FD:03:31:54:2D:99:FA:F9:99:76:41:79:07:73:A9"
                  }
               ]
- language:
    - default: 'en'
    - properties
        - min length = 2
        - max length = 6
    - example: 'pt_PT'