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 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

Example Request


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

Example Response


Last Modified: 22 Feb 2022


Automate Your Workflow With 42matters’ APIs


Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs:



Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!