Quickstart
The Data API returns JSON over HTTPS. You’ll need the client ID and secret supplied by Apptopia.
1. Get a session token
Section titled “1. Get a session token”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.
2. Make a small request
Section titled “2. Make a small request”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.
3. Look up an app
Section titled “3. Look up an app”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.
- Entity lookups retrieve specific apps, publishers, and SDKs.
- Time series retrieve measurements for an ID and date range.
- Discovery pages through a larger dataset.
- Bulk exports returns links to downloadable snapshot files.
Before you scale up
Section titled “Before you scale up”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.