App Reviews API


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

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

5 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 .
p required The package name identifying an Android application. Any publicly available Android app package name
rating optional Filter reviews with a specific rating value. A valid integer number in the range 1 to 5, for example: 4
start_date optional Get reviews newer than this date. A valid date in the format yyyy-MM-dd, for example: 2016-05-24
end_date optional Get reviews older than this date. 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. This field overwrites start_date and end_date. 1-30 30 (if no start_date and end_date)
lang optional Return language-specific reviews. ID of Supported Languages
limit optional Number of reviews to return. 1-100 10
page optional Page based on the limit parameter, used for pagination. 1 - max pages. 1
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
number_reviews Integer Number of reviews returned
total_reviews Integer Number of reviews available based on query/filters used
page Integer Current page
limit Integer Maximum number of reviews per page.
total_pages Integer Number of pages available based on "limit" parameter.
reviews Array of Objects Sorted list of reviews objects in the response. Each reviews contains: author_id, rating, lang, content, date, app_version.
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

Example Response

{
	"package_name": "com.google.android.apps.plus",
	"title": "Google+",
	"developer": "Google LLC",
	"number_ratings": 4203650,
	"rating": 4.2213716506958,
	"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": "",
	"start_date": "2017-10-19",
	"reviews": [
		{
			"author_id": "9bbe70b9bda6d509409cecf218b3e0d4",
			"rating": 3,
			"lang": "en",
			"content": "Last update fix a bug where joined communities disappear, but now everything loads really sloooooooow.",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "be2541610bcf5378028f6a29160a9ea0",
			"rating": 3,
			"lang": "en",
			"content": "The New Update Has Thrown Me Off So Much. The Fact That You Can't Share Files To Outside Applications Is An Inconvenience. I Have Been So Used To Sharing Images To My Photos And Drive That It Threw Me Off So Much. Please Add That Back In So I Don't Quit Google+ Entirely.",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "64760b17f6d1686319b8825dea14fdce",
			"rating": 4,
			"lang": "en",
			"content": "Typing a \"+\" to tag another user quite often brings up an incomplete or incorrect list of names...really annoying.",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "1cdb83f074d66f86b90b280dd9f3b06d",
			"rating": 5,
			"lang": "en",
			"content": "It is wonderful and I love the historical photography and all of the different sites where you can find shared interests!",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "108291c9dce2d79d6d3fdccd3d95087a",
			"rating": 3,
			"lang": "en",
			"content": "Besides the sudden glitches, it's fun to use",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "d13135f6bfab40381eae31664df5178d",
			"rating": 5,
			"lang": "en",
			"content": "G+ is loads of fun!!",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "cefbcbd3b4bd06e660c8ce2f5693276a",
			"rating": 3,
			"lang": "en",
			"content": "Really enjoy the communities but send no control over porn spam. Cant even open this app in public because it's guaranteed to show something. Using it less and less",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "79bbb97fcfd08fbeebda4be4a13c914b",
			"rating": 4,
			"lang": "en",
			"content": "It is more convenient to meet all & most useful .",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "5f15442854ab67e81517169aeb77936b",
			"rating": 3,
			"lang": "en",
			"content": "My favorite people are on it and I love how it all works. But it seems Google doesn't care to fix all the bugs and glitches that the app constantly has.",
			"date": "2017-11-17",
			"app_version": "VARIES"
		},
		{
			"author_id": "68c0a051a10e046e798889d28f8168da",
			"rating": 1,
			"lang": "en",
			"content": "Please fix!! is not working on my galaxy S4 firmware version 5.0.1",
			"date": "2017-11-17",
			"app_version": "VARIES"
		}
	],
	"number_reviews": 10,
	"total_reviews": 899,
	"page": 1,
	"limit": 10,
	"total_pages": 90
}

Last Modified: 2017-10-30


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.


CONTACT US