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
basic 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. 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-01-18",
"end_date": "2020-01-27",
"max_position": 119,
"number_dates": 10,
"dates": [
"2020-01-18",
"2020-01-19",
"2020-01-20",
"2020-01-21",
"2020-01-22",
"2020-01-23",
"2020-01-24",
"2020-01-25",
"2020-01-26",
"2020-01-27"
],
"ranks": [
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2020-01-18",
"position": 28
},
{
"date": "2020-01-19",
"position": 33
},
{
"date": "2020-01-20",
"position": 2
},
{
"date": "2020-01-21",
"position": null
},
{
"date": "2020-01-22",
"position": null
},
{
"date": "2020-01-23",
"position": null
},
{
"date": "2020-01-24",
"position": null
},
{
"date": "2020-01-25",
"position": 2
},
{
"date": "2020-01-26",
"position": 5
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2020-01-18",
"position": 60
},
{
"date": "2020-01-19",
"position": 58
},
{
"date": "2020-01-20",
"position": 56
},
{
"date": "2020-01-21",
"position": 56
},
{
"date": "2020-01-22",
"position": 56
},
{
"date": "2020-01-23",
"position": 56
},
{
"date": "2020-01-24",
"position": 56
},
{
"date": "2020-01-25",
"position": 56
},
{
"date": "2020-01-26",
"position": 57
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2020-01-18",
"position": 10
},
{
"date": "2020-01-19",
"position": 9
},
{
"date": "2020-01-20",
"position": 9
},
{
"date": "2020-01-21",
"position": 9
},
{
"date": "2020-01-22",
"position": 9
},
{
"date": "2020-01-23",
"position": 9
},
{
"date": "2020-01-24",
"position": 9
},
{
"date": "2020-01-25",
"position": 9
},
{
"date": "2020-01-26",
"position": 9
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-01-18",
"position": 1
},
{
"date": "2020-01-19",
"position": 1
},
{
"date": "2020-01-20",
"position": 1
},
{
"date": "2020-01-21",
"position": 1
},
{
"date": "2020-01-22",
"position": 1
},
{
"date": "2020-01-23",
"position": 1
},
{
"date": "2020-01-24",
"position": 1
},
{
"date": "2020-01-25",
"position": 1
},
{
"date": "2020-01-26",
"position": 1
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-01-18",
"position": 4
},
{
"date": "2020-01-19",
"position": 4
},
{
"date": "2020-01-20",
"position": 3
},
{
"date": "2020-01-21",
"position": 3
},
{
"date": "2020-01-22",
"position": 3
},
{
"date": "2020-01-23",
"position": 3
},
{
"date": "2020-01-24",
"position": 4
},
{
"date": "2020-01-25",
"position": 3
},
{
"date": "2020-01-26",
"position": 1
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2020-01-18",
"position": 1
},
{
"date": "2020-01-19",
"position": 1
},
{
"date": "2020-01-20",
"position": 1
},
{
"date": "2020-01-21",
"position": 1
},
{
"date": "2020-01-22",
"position": 1
},
{
"date": "2020-01-23",
"position": 1
},
{
"date": "2020-01-24",
"position": 1
},
{
"date": "2020-01-25",
"position": 1
},
{
"date": "2020-01-26",
"position": 1
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2020-01-18",
"position": null
},
{
"date": "2020-01-19",
"position": 94
},
{
"date": "2020-01-20",
"position": 119
},
{
"date": "2020-01-21",
"position": null
},
{
"date": "2020-01-22",
"position": null
},
{
"date": "2020-01-23",
"position": null
},
{
"date": "2020-01-24",
"position": null
},
{
"date": "2020-01-25",
"position": 60
},
{
"date": "2020-01-26",
"position": 56
},
{
"date": "2020-01-27",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2020-01-18",
"position": null
},
{
"date": "2020-01-19",
"position": null
},
{
"date": "2020-01-20",
"position": 45
},
{
"date": "2020-01-21",
"position": null
},
{
"date": "2020-01-22",
"position": null
},
{
"date": "2020-01-23",
"position": null
},
{
"date": "2020-01-24",
"position": null
},
{
"date": "2020-01-25",
"position": 45
},
{
"date": "2020-01-26",
"position": 32
},
{
"date": "2020-01-27",
"position": null
}
]
}
],
"title": "TikTok - Make Your Day",
"developer": "TikTok Inc.",
"number_ratings": 15576241,
"rating": 4.5967965126038,
"icon": "https://lh3.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA=s180",
"icon_72": "https://lh3.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: 08 Apr 2019
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
Copyright © 2019 42matters AG - All rights reserved
Applications listed on 42matters.com are from the Google Play™ Store, the Apple App Store®, the Amazon AppStore® and the Tencent Myapp® and all the rights belong to their respective owners. Android™ and Google Play™ are trademarks of Google Inc. App Store® and iTunes® are trademarks of Apple Inc. Amazon® and Amazon AppStore® are trademarks of Amazon Inc. Tencent® and Tencent Myapp® are trademarks of Tencent Holdings Limited. Any third party trademark and/or logo displayed on this website, shall NOT be interpreted as any sponsorship, endorsement and/or affiliation with 42matters.