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": "2022-01-18",
"end_date": "2022-01-27",
"country": "US",
"country_name": "United States",
"max_position": 88,
"number_dates": 2,
"dates": [
"2022-01-18",
"2022-01-19"
],
"ranks": [
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2022-01-18",
"position": 7
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2022-01-18",
"position": 1
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2022-01-18",
"position": 8
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2022-01-18",
"position": 3
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2022-01-18",
"position": 2
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2022-01-18",
"position": 18
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2022-01-18",
"position": 3
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2022-01-18",
"position": 88
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2022-01-19",
"position": 19
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2022-01-19",
"position": 2
}
],
"trackCensoredName": "TikTok",
"sellerName": "TikTok Ltd.",
"userRatingCount": 11572716,
"averageUserRating": 4.74898,
"artworkUrl512": "https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/79/51/58/7951580a-2bbe-8b3e-91ea-6da9a3a070b6/source/512x512bb.jpg",
"artworkUrl100": "https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/79/51/58/7951580a-2bbe-8b3e-91ea-6da9a3a070b6/source/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
Schedule an appointment to see how our products can help grow your mobile business.
Copyright © 2022 42matters AG - All rights reserved
Applications listed on 42matters.com are from the Google Play™ Store, the Apple App Store®, the Amazon AppStore®, the Tencent Myapp®, the Apple TV App Store®, the Amazon Fire TV®, and the Roku Channel Store® and all the rights belong to their respective owners. Android™ and Google Play™ are trademarks of Google Inc. App Store®, iTunes® and TV App Store® are trademarks of Apple Inc. Amazon®, Amazon AppStore® and Amazon Fire TV® are trademarks of Amazon Inc. Tencent® and Tencent Myapp® are trademarks of Tencent Holdings Limited. Roku® and Roku Channel Store® are trademarks of Roku Inc. Any third party trademark and/or logo displayed on this website, shall NOT be interpreted as any sponsorship, endorsement and/or affiliation with 42matters.