Get app rank history data for an Android app available on Google Play Store.
GET https://data.42matters.com/api/v2.0/android/apps/ranks.json
3
3 QPS
Small or above.
| 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 | |||||||||||||||
| start_date | optional | The start date of the report. | A valid date in the format yyyy-MM-dd, for example: 2016-05-24 | |||||||||||||||
| end_date | optional | The end date of the report. | A valid date in the format yyyy-MM-dd, for example: 2016-05-30 | |||||||||||||||
| days | optional | Set the date range from yesterday to the specified number of days in the past. | 1-30 | |||||||||||||||
| 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 | |||||||||||||||
| countries | optional | Comma-separated list of countries (ISO code). If no country is specified, all available countries will be returned. | ID of Supported Countries | |||||||||||||||
| 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 | ||||||||||||||
| 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:
{
"package_name": "com.zhiliaoapp.musically",
"start_date": "2020-10-13",
"end_date": "2020-10-22",
"max_position": 352,
"number_dates": 10,
"dates": [
"2020-10-13",
"2020-10-14",
"2020-10-15",
"2020-10-16",
"2020-10-17",
"2020-10-18",
"2020-10-19",
"2020-10-20",
"2020-10-21",
"2020-10-22"
],
"ranks": [
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2020-10-13",
"position": 71
},
{
"date": "2020-10-14",
"position": 95
},
{
"date": "2020-10-15",
"position": 115
},
{
"date": "2020-10-16",
"position": 136
},
{
"date": "2020-10-17",
"position": 153
},
{
"date": "2020-10-18",
"position": 40
},
{
"date": "2020-10-19",
"position": 24
},
{
"date": "2020-10-20",
"position": 50
},
{
"date": "2020-10-21",
"position": null
},
{
"date": "2020-10-22",
"position": 203
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2020-10-13",
"position": 11
},
{
"date": "2020-10-14",
"position": 11
},
{
"date": "2020-10-15",
"position": 12
},
{
"date": "2020-10-16",
"position": 12
},
{
"date": "2020-10-17",
"position": 13
},
{
"date": "2020-10-18",
"position": 16
},
{
"date": "2020-10-19",
"position": 16
},
{
"date": "2020-10-20",
"position": 19
},
{
"date": "2020-10-21",
"position": 18
},
{
"date": "2020-10-22",
"position": 16
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2020-10-13",
"position": 98
},
{
"date": "2020-10-14",
"position": 99
},
{
"date": "2020-10-15",
"position": 100
},
{
"date": "2020-10-16",
"position": 102
},
{
"date": "2020-10-17",
"position": 110
},
{
"date": "2020-10-18",
"position": 108
},
{
"date": "2020-10-19",
"position": 115
},
{
"date": "2020-10-20",
"position": 119
},
{
"date": "2020-10-21",
"position": 121
},
{
"date": "2020-10-22",
"position": 115
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2020-10-13",
"position": 4
},
{
"date": "2020-10-14",
"position": 4
},
{
"date": "2020-10-15",
"position": 4
},
{
"date": "2020-10-16",
"position": 4
},
{
"date": "2020-10-17",
"position": 5
},
{
"date": "2020-10-18",
"position": 5
},
{
"date": "2020-10-19",
"position": 5
},
{
"date": "2020-10-20",
"position": 5
},
{
"date": "2020-10-21",
"position": 5
},
{
"date": "2020-10-22",
"position": 5
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-10-13",
"position": 2
},
{
"date": "2020-10-14",
"position": 2
},
{
"date": "2020-10-15",
"position": 2
},
{
"date": "2020-10-16",
"position": 2
},
{
"date": "2020-10-17",
"position": 2
},
{
"date": "2020-10-18",
"position": 2
},
{
"date": "2020-10-19",
"position": 2
},
{
"date": "2020-10-20",
"position": 2
},
{
"date": "2020-10-21",
"position": 2
},
{
"date": "2020-10-22",
"position": 2
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-10-13",
"position": 4
},
{
"date": "2020-10-14",
"position": 3
},
{
"date": "2020-10-15",
"position": 5
},
{
"date": "2020-10-16",
"position": 4
},
{
"date": "2020-10-17",
"position": 4
},
{
"date": "2020-10-18",
"position": 4
},
{
"date": "2020-10-19",
"position": 4
},
{
"date": "2020-10-20",
"position": 5
},
{
"date": "2020-10-21",
"position": 4
},
{
"date": "2020-10-22",
"position": 5
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-10-13",
"position": 1
},
{
"date": "2020-10-14",
"position": 1
},
{
"date": "2020-10-15",
"position": 1
},
{
"date": "2020-10-16",
"position": 1
},
{
"date": "2020-10-17",
"position": 1
},
{
"date": "2020-10-18",
"position": 1
},
{
"date": "2020-10-19",
"position": 1
},
{
"date": "2020-10-20",
"position": 1
},
{
"date": "2020-10-21",
"position": 1
},
{
"date": "2020-10-22",
"position": 1
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2020-10-13",
"position": null
},
{
"date": "2020-10-14",
"position": null
},
{
"date": "2020-10-15",
"position": null
},
{
"date": "2020-10-16",
"position": null
},
{
"date": "2020-10-17",
"position": 352
},
{
"date": "2020-10-18",
"position": null
},
{
"date": "2020-10-19",
"position": null
},
{
"date": "2020-10-20",
"position": null
},
{
"date": "2020-10-21",
"position": null
},
{
"date": "2020-10-22",
"position": null
}
]
}
],
"title": "TikTok - Trends Start Here",
"developer": "TikTok Pte. Ltd.",
"number_ratings": 26792278,
"rating": 4.527242183685303,
"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: 29 Apr 2020
Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:
Salesforce
HubSpot
Slack
Intercom
Pipedrive
Zendesk
Gekoboard
Klipfolio
Dynamics
Schedule an appointment to see how our products can help grow your mobile business.
Copyright © 2020 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.