App Store iOS App Rank History API. Retrieve comprehensive historical app rank insights for any iOS app available on the Apple App Store.
Example Request
This request can also be imported into Postman.
Check out our Postman integration guide.
Example Response
{
"number_results": 80,
"num_pages": 8,
"has_next": true,
"limit": 10,
"page": 1,
"trackId": "835599320",
"start_date": "2023-05-20",
"end_date": "2023-05-29",
"country": "US",
"country_name": "United States",
"max_position": 71,
"number_dates": 2,
"dates": [
"2023-05-20",
"2023-05-21"
],
"ranks": [
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2023-05-20",
"position": 6
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2023-05-20",
"position": 7
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "iphone",
"date": "2023-05-20",
"position": 1
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2023-05-20",
"position": 1
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2023-05-20",
"position": 3
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "iphone",
"date": "2023-05-20",
"position": 1
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2023-05-20",
"position": 71
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2023-05-20",
"position": 7
},
{
"primary_genre_id": 36,
"primary_genre_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"device_type": "ipad",
"date": "2023-05-21",
"position": 71
},
{
"primary_genre_id": 6016,
"primary_genre_name": "Entertainment",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"device_type": "ipad",
"date": "2023-05-21",
"position": 3
}
],
"trackCensoredName": "TikTok",
"sellerName": "TIKTOK PTE. LTD.",
"userRatingCount": 14820270,
"averageUserRating": 4.75765,
"artworkUrl512": "https://is3-ssl.mzstatic.com/image/thumb/Purple116/v4/d7/0d/40/d70d407c-ff18-5d29-456a-97ac2013bb4f/AppIcon_TikTok-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
"artworkUrl100": "https://is3-ssl.mzstatic.com/image/thumb/Purple116/v4/d7/0d/40/d70d407c-ff18-5d29-456a-97ac2013bb4f/AppIcon_TikTok-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/100x100bb.jpg",
"trackViewUrl": "https://apps.apple.com/us/app/tiktok/id835599320?uo=4&at=10l9yE",
"formattedPrice": "Free"
}