App Reviews API for Android Apps

---

App Reviews API for Google Play Android Apps. Retrieve comprehensive app review data for any Android app available on Google Play.

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

3 QPS

Required plan:

Small or above.

Historical data:

default 30 days (up to 14 years with 'Historical Package')

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 long number in the range 1 to 5, for example: 4
start_date	optional	Get reviews from this date. To get historical data you need to make separate requests for each month as the allowed range per request is max 30 days. With the Historical data package you can go back up to 14 years.	A valid date in the format yyyy-MM-dd, for example: 2020-05-24
end_date	optional	Get reviews until this date. To get historical data you need to make separate requests for each month as the allowed range per request is max 30 days.	A valid date in the format yyyy-MM-dd, for example: 2020-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.	Maximum 30 days
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 Long 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 Long Number of reviews returned total_reviews Long Number of reviews available based on query/filters used page Long Current page limit Long Maximum number of reviews per page. total_pages Long Number of pages available based on "limit" parameter. reviews Array of Objects Sorted list of reviews objects in the response. Each reviews contains: author_hash, rating, lang, content, date, app_version. Please note that author_hash is a hash, whose value might change for the same author and it should not be used to track separate authors or reviews.
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

Reviews for the Facebook app on Google Play:

https://data.42matters.com/api/v4.0/android/apps/reviews.json?p=com.facebook.katana&access_token=YOUR_ACCESS_TOKEN

---

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

Last Modified: 03 May 2023