Get Free Support
We offer free email support to all our customers, with the 42matters team glad to provide you prompt, professional support. We’re here to help.
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
5 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 are 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 Google+ app on Google Play:
{
"package_name": "com.google.android.apps.plus",
"start_date": "2017-06-19",
"end_date": "2017-06-28",
"max_position": 413,
"number_dates": 10,
"dates": [
"2017-06-19",
"2017-06-20",
"2017-06-21",
"2017-06-22",
"2017-06-23",
"2017-06-24",
"2017-06-25",
"2017-06-26",
"2017-06-27",
"2017-06-28"
],
"ranks": [
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2017-06-19",
"position": 365
},
{
"date": "2017-06-20",
"position": 373
},
{
"date": "2017-06-21",
"position": 372
},
{
"date": "2017-06-22",
"position": 338
},
{
"date": "2017-06-23",
"position": 384
},
{
"date": "2017-06-24",
"position": 383
},
{
"date": "2017-06-25",
"position": 345
},
{
"date": "2017-06-26",
"position": 325
},
{
"date": "2017-06-27",
"position": 325
},
{
"date": "2017-06-28",
"position": 350
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "topselling_free",
"list_title": "Top Selling Free",
"positions": [
{
"date": "2017-06-19",
"position": 22
},
{
"date": "2017-06-20",
"position": 22
},
{
"date": "2017-06-21",
"position": 22
},
{
"date": "2017-06-22",
"position": 23
},
{
"date": "2017-06-23",
"position": 23
},
{
"date": "2017-06-24",
"position": 23
},
{
"date": "2017-06-25",
"position": 23
},
{
"date": "2017-06-26",
"position": 23
},
{
"date": "2017-06-27",
"position": 23
},
{
"date": "2017-06-28",
"position": 24
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "APPLICATION",
"category_name": "Application",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2017-06-19",
"position": null
},
{
"date": "2017-06-20",
"position": null
},
{
"date": "2017-06-21",
"position": null
},
{
"date": "2017-06-22",
"position": 413
},
{
"date": "2017-06-23",
"position": null
},
{
"date": "2017-06-24",
"position": null
},
{
"date": "2017-06-25",
"position": null
},
{
"date": "2017-06-26",
"position": null
},
{
"date": "2017-06-27",
"position": null
},
{
"date": "2017-06-28",
"position": null
}
]
},
{
"country": "US",
"country_name": "United States",
"cat_key": "SOCIAL",
"category_name": "Social",
"list_name": "movers_shakers",
"list_title": "Top Trending",
"positions": [
{
"date": "2017-06-19",
"position": null
},
{
"date": "2017-06-20",
"position": null
},
{
"date": "2017-06-21",
"position": null
},
{
"date": "2017-06-22",
"position": 20
},
{
"date": "2017-06-23",
"position": null
},
{
"date": "2017-06-24",
"position": null
},
{
"date": "2017-06-25",
"position": 120
},
{
"date": "2017-06-26",
"position": 98
},
{
"date": "2017-06-27",
"position": 98
},
{
"date": "2017-06-28",
"position": 108
}
]
}
],
"title": "Google+",
"developer": "Google Inc.",
"number_ratings": 3854900,
"rating": 4.2117557525635,
"icon": "https://lh3.googleusercontent.com/N-AY2XwXafWq4TQWfua6VyjPVQvTGRdz9CKOHaBl2nu2GVg7zxS886X5giZ9yY2qIjPh=w300",
"icon_72": "https://lh3.googleusercontent.com/N-AY2XwXafWq4TQWfua6VyjPVQvTGRdz9CKOHaBl2nu2GVg7zxS886X5giZ9yY2qIjPh=w72",
"market_url": "https://play.google.com/store/apps/details?id=com.google.android.apps.plus&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
"price": ""
}Last Modified: 2016-09-26
We offer free email support to all our customers, with the 42matters team glad to provide you prompt, professional support. We’re here to help.
Copyright © 2017 42matters AG - All rights reserved
Applications listed on 42matters.com are from the Google Play™ Store and the Apple App Store® 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. Any third party trademark and/or logo displayed on this website, shall NOT be interpreted as any sponsorship, endorsement and/or affiliation with 42matters.
