App Store iOS App Rank History API. Retrieve comprehensive historical app rank insights for any iOS app available on the Apple App Store.
GET https://data.42matters.com/api/v4.0/ios/apps/ranks.json
3
3 QPS
Small or above.
default 30 days (up to 1 year with 'Historical Package')
| Name | Required | Description | Available Values | Default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| access_token | required | Your access token for using this API. You can get it for FREE by signing up. | ||||||||
| id | required | The app ID on the Apple App Store - (e.g for Facebook the ID is 284882215). | Existing App ID on Apple App Store | |||||||
| country | optional | ISO code of the country. If no country is specified, US will be used. | List of Supported Countries | US | ||||||
| start_date | optional | The start date of the report. | A valid date in the format yyyy-MM-dd, for example: 2020-05-24 | |||||||
| end_date | optional | The end date of the report. | A valid date in the format yyyy-MM-dd, for example: 2020-05-30 | |||||||
| days | optional | Set the date range from yesterday to the specified number of days in the past. | Without Historical Package: Last 30 days. With Historical Package: up to 1 year | 1 | ||||||
| list_names | optional | Comma-separated list of list_name values. If no list_name is specified, all available list_names will be returned. |
|
|||||||
| device_types | optional | Comma-separated list of Device Types. If no device_type is specified, all available device_types will be returned. |
|
|||||||
| primaryGenreIds | optional | Comma-separated list of App Primary Genre Ids. If no primaryGenreId is specified, all available primaryGenreIds will be returned. | ID of App Store Genres | |||||||
| lang | optional | Return language-specific metadata. If no translation is available the default language of the app is used. Internationalized fields include title, short_desc, description, what_is_new, screenshots. | ID of Supported Languages | en | ||||||
| app_country | optional | Return country-specific app metadata. Country-specific fields are include currency, price, formattedPrice, userRatingCount, userRatingCountForCurrentVersion, averageUserRating, averageUserRatingForCurrentVersion. If the country is not supported, then the default metadata of the app is returned. | ID of Supported Countries | US | ||||||
| sort_order | optional | Ordering by date | desc or asc | asc | ||||||
| limit | optional | Number of ranks to return. | 1-100 | 100 | ||||||
| page | optional | Page based on the limit parameter, used for pagination. | 1 - max pages. | 1 | ||||||
| callback | optional | If supplied, the response will use the JSONP format with a callback of the given name. |
| Status Code | Indication | Content-Type | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Everything is OK | application/json |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 404 | The track id/bundle id is not found | application/json | Error object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 402 | Your request exceeds what's allowed by your current subscription plan | application/json | Error object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 403 | Your access token is not valid | application/json | Error object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 429 | Your request rate is over the limit | application/json | Error object |
Ranks for the TikTok app on Apple App Store:
{
"number_results": 80,
"num_pages": 8,
"has_next": true,
"limit": 10,
"page": 1,
"trackId": "835599320",
"start_date": "2025-05-17",
"end_date": "2025-05-26",
"country": "US",
"country_name": "United States",
"max_position": 35,
"number_dates": 2,
"dates": [
"2025-05-17",
"2025-05-18"
],
"ranks": [
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2025-05-17",
"position": 15
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2025-05-17",
"position": 10
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2025-05-17",
"position": 2
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2025-05-17",
"position": 6
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2025-05-17",
"position": 35
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2025-05-17",
"position": 1
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2025-05-17",
"position": 6
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2025-05-17",
"position": 2
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2025-05-18",
"position": 6
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2025-05-18",
"position": 7
}
],
"trackCensoredName": "TikTok - Videos, Music & LIVE",
"sellerName": "TIKTOK PTE. LTD.",
"userRatingCount": 18135474,
"averageUserRating": 4.74245,
"artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/ab/53/cc/ab53cc04-35b9-66f1-d811-d67f16482515/AppIcon_TikTok-0-0-1x_U007epad-0-1-0-0-85-220.png/512x512bb.jpg",
"artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/ab/53/cc/ab53cc04-35b9-66f1-d811-d67f16482515/AppIcon_TikTok-0-0-1x_U007epad-0-1-0-0-85-220.png/100x100bb.jpg",
"trackViewUrl": "https://apps.apple.com/us/app/tiktok/id835599320?uo=4&at=10l9yE",
"formattedPrice": "Free"
}Last Modified: 7 Oct 2021
Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs:
Salesforce
HubSpot
Slack
Intercom
Pipedrive
Zendesk
Gekoboard
Klipfolio
Dynamics
To use this feature you need to accept our "Functional Cookies" (or all our Cookies) as described in our Cookie Policy. To accept the "Functional Cookies" (or all our Cookies) please click here:
Cookie Settings