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/v2.0/android/apps/reviews.json

Hits per request:

3

Rate limit:

3 QPS

Required plan:

Small 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.facebook.katana",
  "title": "Facebook",
  "developer": "Facebook",
  "number_ratings": 105256363,
  "rating": 4.1400532722473145,
  "icon": "https://play-lh.googleusercontent.com/ccWDU4A7fX1R24v-vvT480ySh26AYp97g1VrIB_FIdjRcuQB2JP2WdY7h_wVVAeSpg=s180",
  "icon_72": "https://play-lh.googleusercontent.com/ccWDU4A7fX1R24v-vvT480ySh26AYp97g1VrIB_FIdjRcuQB2JP2WdY7h_wVVAeSpg=s180-rw",
  "market_url": "https://play.google.com/store/apps/details?id=com.facebook.katana&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
  "price": "",
  "start_date": "2020-10-29",
  "reviews": [
    {
      "author_id": "5a89428d1b1064befbce11183068f283",
      "rating": 5,
      "lang": "en",
      "content": "Good app",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "147ad694c1d8e82ade452b466971426e",
      "rating": 5,
      "lang": "en",
      "content": "Ok",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "29a180c29815d5ce9f55d7a58fdc487a",
      "rating": 1,
      "lang": "en",
      "content": "Stop censoring!",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "227c0ed9aa6f85e2efe1cff5340be28d",
      "rating": 4,
      "lang": "en",
      "content": "Good App",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "7e068ae3a23b18cbbc2a4ccb90ad161d",
      "rating": 5,
      "lang": "en",
      "content": "Awesome",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "13c1cc614847022d4fc43d21815f533a",
      "rating": 1,
      "lang": "en",
      "content": "#khadimHussainRizvi",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "db53d48cc678be775f5d27d8832cd811",
      "rating": 5,
      "lang": "en",
      "content": "Good",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "16ee6b744ffacb637e02fed99b892a5e",
      "rating": 1,
      "lang": "en",
      "content": "Blocked any thing of value and pushed lies and useless garbage.",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "31a9de0371bb03339afc657360fa005b",
      "rating": 1,
      "lang": "en",
      "content": "Stop islamophobia",
      "date": "2020-11-27",
      "app_version": "VARIES"
    },
    {
      "author_id": "088dadf0ebed8a69b6109ada450558a3",
      "rating": 4,
      "lang": "en",
      "content": "Good",
      "date": "2020-11-27",
      "app_version": "VARIES"
    }
  ],
  "number_reviews": 10,
  "total_reviews": 59560,
  "page": 1,
  "limit": 10,
  "total_pages": 5956
}

Last Modified: 29 Apr 2020


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:



Email

Email

Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!