Google Play App Rank History API

Get app rank history data for an Android app available on Google Play Store.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/android/apps/ranks.json

Hits per request:

Rate limit:

3 QPS

Required plan:

basic or above.

Parameters

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 .

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.

Name	Description
topselling_free	Top Selling Free
topselling_paid	Top Selling Paid
movers_shakers	Top Trending
topgrossing	Top Grossing Apps
topselling_new_free	Top New Free
topselling_new_paid	Top New Paid

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

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

callback

optional

If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code

Indication

Content-Type

Body

200

Everything is OK

application/json

Attribute	Type	Description
package_name	String	The app package name (unique identifier)
title	String	App title
developer	String	App developer name
number_ratings	Integer	Number of app ratings
rating	Double	App rating (from 0 to 5, 5 highest)
icon	URL	Full-sized icon. Format can be either webp or png. In order to request png format, remove the trailing "-rw" from the url.
icon_72	URL	App icon (72x72 pixels)
price	String	App price with currency (if paid)
market_url	URL	A deep link to the app page on Google Play
start_date	Date	A date in the format: yyyy-MM-dd
end_date	Date	A date in the format: yyyy-MM-dd
max_position	Integer	The maximum position among all ranks. Useful to set custom ranges in your charts.
number_dates	Integer	Number of dates in the response
dates	Array of dates	Sorted list of dates in the response
ranks	Array of Objects	Sorted list of rank objects in the response. Each rank contains: country, country_name, cat_key, category_name, list_name, list_title, positions (in the returned dates). If a position is null, it means the app is not in this chart on that day.

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

Example Request

Ranks for the TikTok app on Google Play:

https://data.42matters.com/api/v2.0/android/apps/ranks.json?p=com.zhiliaoapp.musically&days=10&access_token=YOUR_ACCESS_TOKEN

Example Response

{
	"package_name": "com.zhiliaoapp.musically",
	"start_date": "2019-05-12",
	"end_date": "2019-05-21",
	"max_position": 242,
	"number_dates": 10,
	"dates": [
		"2019-05-12",
		"2019-05-13",
		"2019-05-14",
		"2019-05-15",
		"2019-05-16",
		"2019-05-17",
		"2019-05-18",
		"2019-05-19",
		"2019-05-20",
		"2019-05-21"
	],
	"ranks": [
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "APPLICATION",
			"category_name": "Application",
			"list_name": "topgrossing",
			"list_title": "Top Grossing Apps",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 34
				},
				{
					"date": "2019-05-13",
					"position": 35
				},
				{
					"date": "2019-05-14",
					"position": 36
				},
				{
					"date": "2019-05-15",
					"position": 37
				},
				{
					"date": "2019-05-16",
					"position": 36
				},
				{
					"date": "2019-05-17",
					"position": 38
				},
				{
					"date": "2019-05-18",
					"position": 40
				},
				{
					"date": "2019-05-19",
					"position": 40
				},
				{
					"date": "2019-05-20",
					"position": 36
				},
				{
					"date": "2019-05-21",
					"position": 37
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "OVERALL",
			"category_name": "Overall",
			"list_name": "topgrossing",
			"list_title": "Top Grossing Apps",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 229
				},
				{
					"date": "2019-05-13",
					"position": 229
				},
				{
					"date": "2019-05-14",
					"position": 228
				},
				{
					"date": "2019-05-15",
					"position": 234
				},
				{
					"date": "2019-05-16",
					"position": 234
				},
				{
					"date": "2019-05-17",
					"position": 237
				},
				{
					"date": "2019-05-18",
					"position": 242
				},
				{
					"date": "2019-05-19",
					"position": 242
				},
				{
					"date": "2019-05-20",
					"position": 228
				},
				{
					"date": "2019-05-21",
					"position": 234
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "SOCIAL",
			"category_name": "Social",
			"list_name": "topgrossing",
			"list_title": "Top Grossing Apps",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 8
				},
				{
					"date": "2019-05-13",
					"position": 9
				},
				{
					"date": "2019-05-14",
					"position": 9
				},
				{
					"date": "2019-05-15",
					"position": 9
				},
				{
					"date": "2019-05-16",
					"position": 9
				},
				{
					"date": "2019-05-17",
					"position": 9
				},
				{
					"date": "2019-05-18",
					"position": 10
				},
				{
					"date": "2019-05-19",
					"position": 10
				},
				{
					"date": "2019-05-20",
					"position": 9
				},
				{
					"date": "2019-05-21",
					"position": 10
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "APPLICATION",
			"category_name": "Application",
			"list_name": "topselling_free",
			"list_title": "Top Selling Free",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 14
				},
				{
					"date": "2019-05-13",
					"position": 8
				},
				{
					"date": "2019-05-14",
					"position": 10
				},
				{
					"date": "2019-05-15",
					"position": 9
				},
				{
					"date": "2019-05-16",
					"position": 10
				},
				{
					"date": "2019-05-17",
					"position": 12
				},
				{
					"date": "2019-05-18",
					"position": 11
				},
				{
					"date": "2019-05-19",
					"position": 11
				},
				{
					"date": "2019-05-20",
					"position": 8
				},
				{
					"date": "2019-05-21",
					"position": 9
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "OVERALL",
			"category_name": "Overall",
			"list_name": "topselling_free",
			"list_title": "Top Selling Free",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 21
				},
				{
					"date": "2019-05-13",
					"position": 19
				},
				{
					"date": "2019-05-14",
					"position": 21
				},
				{
					"date": "2019-05-15",
					"position": 20
				},
				{
					"date": "2019-05-16",
					"position": 21
				},
				{
					"date": "2019-05-17",
					"position": 23
				},
				{
					"date": "2019-05-18",
					"position": 23
				},
				{
					"date": "2019-05-19",
					"position": 23
				},
				{
					"date": "2019-05-20",
					"position": 21
				},
				{
					"date": "2019-05-21",
					"position": 23
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "SOCIAL",
			"category_name": "Social",
			"list_name": "topselling_free",
			"list_title": "Top Selling Free",
			"positions": [
				{
					"date": "2019-05-12",
					"position": 5
				},
				{
					"date": "2019-05-13",
					"position": 4
				},
				{
					"date": "2019-05-14",
					"position": 4
				},
				{
					"date": "2019-05-15",
					"position": 5
				},
				{
					"date": "2019-05-16",
					"position": 5
				},
				{
					"date": "2019-05-17",
					"position": 5
				},
				{
					"date": "2019-05-18",
					"position": 4
				},
				{
					"date": "2019-05-19",
					"position": 4
				},
				{
					"date": "2019-05-20",
					"position": 3
				},
				{
					"date": "2019-05-21",
					"position": 3
				}
			]
		},
		{
			"country": "US",
			"country_name": "United States",
			"cat_key": "APPLICATION",
			"category_name": "Application",
			"list_name": "movers_shakers",
			"list_title": "Top Trending",
			"positions": [
				{
					"date": "2019-05-12",
					"position": null
				},
				{
					"date": "2019-05-13",
					"position": null
				},
				{
					"date": "2019-05-14",
					"position": null
				},
				{
					"date": "2019-05-15",
					"position": null
				},
				{
					"date": "2019-05-16",
					"position": null
				},
				{
					"date": "2019-05-17",
					"position": null
				},
				{
					"date": "2019-05-18",
					"position": null
				},
				{
					"date": "2019-05-19",
					"position": null
				},
				{
					"date": "2019-05-20",
					"position": 72
				},
				{
					"date": "2019-05-21",
					"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-05-12",
					"position": null
				},
				{
					"date": "2019-05-13",
					"position": null
				},
				{
					"date": "2019-05-14",
					"position": null
				},
				{
					"date": "2019-05-15",
					"position": null
				},
				{
					"date": "2019-05-16",
					"position": null
				},
				{
					"date": "2019-05-17",
					"position": null
				},
				{
					"date": "2019-05-18",
					"position": null
				},
				{
					"date": "2019-05-19",
					"position": null
				},
				{
					"date": "2019-05-20",
					"position": 166
				},
				{
					"date": "2019-05-21",
					"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-05-12",
					"position": null
				},
				{
					"date": "2019-05-13",
					"position": null
				},
				{
					"date": "2019-05-14",
					"position": null
				},
				{
					"date": "2019-05-15",
					"position": null
				},
				{
					"date": "2019-05-16",
					"position": null
				},
				{
					"date": "2019-05-17",
					"position": null
				},
				{
					"date": "2019-05-18",
					"position": null
				},
				{
					"date": "2019-05-19",
					"position": null
				},
				{
					"date": "2019-05-20",
					"position": 6
				},
				{
					"date": "2019-05-21",
					"position": null
				}
			]
		}
	],
	"title": "TikTok",
	"developer": "musical.ly",
	"number_ratings": 10425475,
	"rating": 4.3909840583801,
	"icon": "https://lh3.googleusercontent.com/iBYjvYuNq8BB7EEEHktPG1fpX9NiY7Jcyg1iRtQxO442r9CZ8H-X9cLkTjpbORwWDG9d=s180",
	"icon_72": "https://lh3.googleusercontent.com/iBYjvYuNq8BB7EEEHktPG1fpX9NiY7Jcyg1iRtQxO442r9CZ8H-X9cLkTjpbORwWDG9d=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

Automate your workflow

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

And many more!

GET FREE INTEGRATIONS via Zapier!

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.

Google Play App Rank History API

Definition

Parameters

Responses

Example Request

Example Response

Automate your workflow

And many more!

Want to know more?