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": "2019-09-09",
"end_date": "2019-09-18",
"max_position": 240,
"number_dates": 10,
"dates": [
"2019-09-09",
"2019-09-10",
"2019-09-11",
"2019-09-12",
"2019-09-13",
"2019-09-14",
"2019-09-15",
"2019-09-16",
"2019-09-17",
"2019-09-18"
],
"ranks": [
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2019-09-09",
"position": 36
},
{
"date": "2019-09-10",
"position": 36
},
{
"date": "2019-09-11",
"position": 39
},
{
"date": "2019-09-12",
"position": 39
},
{
"date": "2019-09-13",
"position": 39
},
{
"date": "2019-09-14",
"position": 36
},
{
"date": "2019-09-15",
"position": 37
},
{
"date": "2019-09-16",
"position": 37
},
{
"date": "2019-09-17",
"position": 38
},
{
"date": "2019-09-18",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2019-09-09",
"position": 240
},
{
"date": "2019-09-10",
"position": 240
},
{
"date": "2019-09-11",
"position": null
},
{
"date": "2019-09-12",
"position": null
},
{
"date": "2019-09-13",
"position": null
},
{
"date": "2019-09-14",
"position": null
},
{
"date": "2019-09-15",
"position": null
},
{
"date": "2019-09-16",
"position": null
},
{
"date": "2019-09-17",
"position": null
},
{
"date": "2019-09-18",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topgrossing",
"list_title": "Top Grossing Apps",
"positions": [
{
"date": "2019-09-09",
"position": 9
},
{
"date": "2019-09-10",
"position": 9
},
{
"date": "2019-09-11",
"position": 9
},
{
"date": "2019-09-12",
"position": 9
},
{
"date": "2019-09-13",
"position": 9
},
{
"date": "2019-09-14",
"position": 8
},
{
"date": "2019-09-15",
"position": 8
},
{
"date": "2019-09-16",
"position": 8
},
{
"date": "2019-09-17",
"position": 8
},
{
"date": "2019-09-18",
"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": "2019-09-09",
"position": 3
},
{
"date": "2019-09-10",
"position": 5
},
{
"date": "2019-09-11",
"position": 5
},
{
"date": "2019-09-12",
"position": 4
},
{
"date": "2019-09-13",
"position": 5
},
{
"date": "2019-09-14",
"position": 10
},
{
"date": "2019-09-15",
"position": 7
},
{
"date": "2019-09-16",
"position": 6
},
{
"date": "2019-09-17",
"position": 5
},
{
"date": "2019-09-18",
"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": "2019-09-09",
"position": 13
},
{
"date": "2019-09-10",
"position": 12
},
{
"date": "2019-09-11",
"position": 8
},
{
"date": "2019-09-12",
"position": 8
},
{
"date": "2019-09-13",
"position": 6
},
{
"date": "2019-09-14",
"position": 14
},
{
"date": "2019-09-15",
"position": 9
},
{
"date": "2019-09-16",
"position": 9
},
{
"date": "2019-09-17",
"position": 8
},
{
"date": "2019-09-18",
"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": "2019-09-09",
"position": 1
},
{
"date": "2019-09-10",
"position": 1
},
{
"date": "2019-09-11",
"position": 1
},
{
"date": "2019-09-12",
"position": 1
},
{
"date": "2019-09-13",
"position": 1
},
{
"date": "2019-09-14",
"position": 1
},
{
"date": "2019-09-15",
"position": 4
},
{
"date": "2019-09-16",
"position": 3
},
{
"date": "2019-09-17",
"position": 2
},
{
"date": "2019-09-18",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2019-09-09",
"position": null
},
{
"date": "2019-09-10",
"position": null
},
{
"date": "2019-09-11",
"position": null
},
{
"date": "2019-09-12",
"position": null
},
{
"date": "2019-09-13",
"position": null
},
{
"date": "2019-09-14",
"position": null
},
{
"date": "2019-09-15",
"position": 122
},
{
"date": "2019-09-16",
"position": 31
},
{
"date": "2019-09-17",
"position": 239
},
{
"date": "2019-09-18",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2019-09-09",
"position": null
},
{
"date": "2019-09-10",
"position": null
},
{
"date": "2019-09-11",
"position": null
},
{
"date": "2019-09-12",
"position": null
},
{
"date": "2019-09-13",
"position": null
},
{
"date": "2019-09-14",
"position": null
},
{
"date": "2019-09-15",
"position": 3
},
{
"date": "2019-09-16",
"position": 1
},
{
"date": "2019-09-17",
"position": 8
},
{
"date": "2019-09-18",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "OVERALL",
"category_name": "Overall",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2019-09-09",
"position": null
},
{
"date": "2019-09-10",
"position": null
},
{
"date": "2019-09-11",
"position": null
},
{
"date": "2019-09-12",
"position": null
},
{
"date": "2019-09-13",
"position": null
},
{
"date": "2019-09-14",
"position": null
},
{
"date": "2019-09-15",
"position": null
},
{
"date": "2019-09-16",
"position": 110
},
{
"date": "2019-09-17",
"position": null
},
{
"date": "2019-09-18",
"position": null
}
]
}
],
"title": "TikTok - Make Your Day",
"developer": "TikTok Inc.",
"number_ratings": 12234719,
"rating": 4.3316507339478,
"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.