API endpoints
All paths are relative to https://integrations.apptopia.com. Data requests require your session token in the Authorization header.
Replace :store with itunes_connect for Apple App Store or google_play for Google Play. Your account determines which datasets you can access. Custom reports can also use unified to combine data from these two stores.
Open the API playground to configure any of these requests and generate cURL, Node.js, and Python examples.
Authentication
Section titled “Authentication”POST /api/login exchanges your form-encoded client and secret for a session token. See Authentication.
Documented routes
Section titled “Documented routes”| Method | Route | Reference |
|---|---|---|
GET |
/api/countries |
Countries |
GET |
/api/:store/categories |
Store categories |
GET |
/api/tags |
Tag library |
GET |
/api/parent_company |
Parent companies |
GET |
/api/:store/app |
Apps |
GET |
/api/:store/app_versions |
App versions |
GET |
/api/:store/publisher |
Publishers |
GET |
/api/:store/sdk |
SDKs |
GET |
/api/:store/app_sdks |
Installed SDKs |
GET |
/api/:store/app_files |
App files |
GET |
/api/:store/app_tags |
App tags |
GET |
/api/:store/estimates |
App estimates |
GET |
/api/:store/app_sessions |
App sessions |
GET |
/api/:store/ratings |
App ratings |
GET |
/api/:store/app_ranks |
App ranks |
GET |
/api/:store/app_ranks_summary |
App ranks summary |
GET |
/api/:store/publisher_estimates |
Publisher estimates |
GET |
/api/:store/sdk_category_performance |
SDK category performance |
GET |
/api/:store/app/discovery |
Discover apps |
GET |
/api/:store/publisher/discovery |
Discover publishers |
GET |
/api/:store/sdk/discovery |
Discover sdks |
GET |
/api/:store/app_sdks/discovery |
Discover installed sdks |
GET |
/api/parent_company/discovery |
Discover parent companies |
GET |
/api/app_estimates/discovery |
Discover app estimates |
GET |
/api/app_sessions/discovery |
Discover app sessions |
GET |
/api/publisher_estimates/discovery |
Discover publisher estimates |
GET |
/api/:store/ratings/discovery |
Discover ratings |
GET |
/api/:store/rank_lists |
Store top charts |
GET |
/api/:store/featured_lists |
Featured apps |
GET |
/api/:store/app_daily_rank_change |
Daily rank change |
GET |
/api/:store/new_releases |
New releases |
GET |
/api/:store/app_graph |
Cross app usage |
GET |
/api/:store/inapp_purchases |
In-app purchases |
GET |
/api/:store/app_retention |
App retention |
GET |
/api/:store/category_retention |
Category retention |
GET |
/api/:store/app_demographics |
App demographics |
GET |
/api/:store/app_graph/discovery |
Discover cross app usage |
GET |
/api/:store/app_retention/discovery |
Discover app retention |
GET |
/api/:store/category_retention/discovery |
Discover category retention |
GET |
/api/:store/app_demographics/discovery |
Discover app demographics |
GET |
/api/:store/app_ads_txt |
App ads.txt |
GET |
/api/:store/pub_ads_txt |
Publisher ads.txt |
GET |
/api/:store/acquisition/top_advertisers |
Top advertisers |
GET |
/api/:store/acquisition/top_publishers |
Top ad publishers |
GET |
/api/:store/reviews/summary |
Reviews summary |
GET |
/api/:store/data_dumps |
Bulk data exports |
GET |
/api/:store/custom_reports |
Custom data reports |
POST |
/api/app_search |
Search apps |
POST |
/api/publisher_search |
Search publishers |
POST |
/api/parent_company_search |
Search parent companies |
POST |
/api/publisher_match |
Match publishers |
The daily-rank-change route is /api/:store/app_daily_rank_change.