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
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 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 |
30 days ago |
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 |
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_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 |
Last Modified: 22 Feb 2022