Google Play App Rank History API. Retrieve comprehensive historical app rank insights for any Android app available on Google Play.
GET https://data.42matters.com/api/v4.0/android/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 . | ||||||||||||||||
| p | required | The package name identifying an Android application. | Any publicly available Android app package name | |||||||||||||||
| 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. |
|
|||||||||||||||
| cat_keys | optional | Comma-separated list of cat_key values. If no cat_key is specified, all available cat_keys will be returned. | ID of Google Play Categories | |||||||||||||||
| 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 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 package name 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 Google Play:
{
"number_results": 61,
"num_pages": 7,
"has_next": true,
"limit": 10,
"page": 1,
"package_name": "com.zhiliaoapp.musically",
"start_date": "2022-05-08",
"end_date": "2022-05-17",
"country": "US",
"country_name": "United States",
"max_position": 659,
"number_dates": 2,
"dates": [
"2022-05-08",
"2022-05-09"
],
"ranks": [
{
"cat_key": "APPLICATION",
"category_name": "All apps",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"date": "2022-05-08",
"position": 1
},
{
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"date": "2022-05-08",
"position": 1
},
{
"cat_key": "APPLICATION",
"category_name": "All apps",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"date": "2022-05-08",
"position": 404
},
{
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"date": "2022-05-08",
"position": 659
},
{
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"date": "2022-05-08",
"position": 4
},
{
"cat_key": "APPLICATION",
"category_name": "All apps",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"date": "2022-05-08",
"position": 2
},
{
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"date": "2022-05-08",
"position": 1
},
{
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"date": "2022-05-08",
"position": 16
},
{
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"date": "2022-05-08",
"position": 1
},
{
"cat_key": "APPLICATION",
"category_name": "All apps",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"date": "2022-05-09",
"position": 1
}
],
"title": "TikTok",
"developer": "TikTok Pte. Ltd.",
"number_ratings": 48686563,
"rating": 4.486293792724609,
"icon": "https://play-lh.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA=s180",
"icon_72": "https://play-lh.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA=s180-rw",
"market_url": "https://play.google.com/store/apps/details?id=com.zhiliaoapp.musically&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
"price": ""
}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.