All Reviews

GET 5 Credits / Request /android/applications/{APPLICATION_ID}/reviews.json

All Reviews allows you to fetch the top 100 reviews entries that AppTweak has been able to gather about a specific app on the App Store in the selected country.

Please note that the example has been stripped of redundant data to keep the documentation as concise as possible. The API might return additional, undocumented fields in the JSON, which your App should not rely upon.

All Reviews Request

The Review list contains a series of review entries describing comments made by users on the app in the selected country. We limit the number of reviews returned by the API to the first 100 items without regard the period (dates range).

By default, these results are sorted by the following criterion: Most Helpful, in the same way, as Google does in its Store.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
language: string en

The two letter language (ISO Alpha-2) you want to fetch the reviews for.

Get the list of our language codes, here.

GET /android/applications/{APPLICATION_ID}/reviews.json

Request example
GET /android/applications/com.facebook.katana/reviews.json?language=en
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/applications/com.facebook.katana/reviews.json?language=en"

All Reviews Response

The response to the application reviews request is a JSON hash containing all the existing review entries for the given application in the selected language on the Play Store.

Object properties
application_id: number

The ID that Google has given to the application.

author: hash

Key/value pairs containing the informations related to the author of the review (name, photo and profile).

CHILD PROPERTIES

name: string

Author's name.

photo: string

Author's photo URL

profile: number

Author's profile.

body: string

The "body" of the review, its main content.

body_length: number

The number of characters used in the body of the review.

language: string

The two letter language (ISO Alpha-2) the reviews were fetched for.

date: datetime

The date on which the review has been posted on the Play Store for the related application.

id: number

The ID that Google has given to the review.

rating: number

The number of stars the user gave to the application (Integer 1 => 5).

sort_score: hash

Key/value pairs describing the score of this review depending on the type of sort (most_useful, most_recent, most_critical and most_positive).

title: string

The review title.

version: string

The version of the app which the user was using when they made the review

Response Example

{
  "content": [
    {
      "language": "en",
      "application_id": "com.facebook.katana",
      "version": "281.0.0.36.124",
      "date": "2020-08-04T15:21:54Z",
      "rating": 1,
      "title": "",
      "body": "There had many bugs since the update, I cant access the prev and fastforward 10sec on the side of videos. I can't watch the playlist normally, when I watch one episode then I'm done with it, it goes back to watch icon, then I have to go back to my profile and search for it again. Get back the friend request button, its more convinient with it, than to be on the notif. Please fix it.",
      "body_length": 385,
      "id": "gp:AOqpTOHtcYOzCqcYQW1Ugo4S69In-cfnnRh1ebOyxOxP0HiI_o6T1O8zL6Gk1WH00WUiKVJJkLo8rZNVXAYZgQ",
      "author": {
        "name": "Jhueca Usui",
        "photo": "https://lh3.googleusercontent.com/a-/AOh14Gg9mRBpGI2E0-mM7IeumRXRxyG_vNa305BLBQU9aw",
        "profile": ""
      },
      "sort_score": {
        "most_useful": 1598452793
      }
    }
  ],
  "metadata": {
    "request": {
      "path": "/applications/com.facebook.katana/reviews.json",
      "store": "android",
      "params": {
        "language": "en",
        "id": "com.facebook.katana",
        "format": "json"
      },
      "performed_at": "2020-08-27 06:50:03 UTC"
    },
    "content": {
    }
  }
}