Skip to content

Quickstart

The Data API returns JSON over HTTPS. You’ll need the client ID and secret supplied by Apptopia.

Send a POST request to /api/login with your credentials as form-encoded fields. The response contains a token.

Set APPTOPIA_CLIENT and APPTOPIA_SECRET in your local environment before running the example. Keep the returned token available as APPTOPIA_TOKEN for subsequent requests. See Authentication for the full flow.

Start with /api/countries. It has no query parameters and returns the supported country list.

In the playground, either sign in with your client ID and secret or use an existing token. Choose a code tab to copy the same request for your own application.

Use /api/itunes_connect/app?id=389801252 to look up an App Store app, or select Google Play and use its package ID, such as com.instagram.android.

Use at most 50 IDs per lookup and 180 days per time series request. Handle HTTP 429 with exponential backoff. Your subscription controls access to individual datasets and history. See Limits & errors.