---
title: "Retrieve Google Play reviews"
method: GET
path: "/googleplay/reviews"
tags: ["GooglePlay"]
---

# Retrieve Google Play reviews

`GET /googleplay/reviews`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/googleplay/reviews`
- Auth: API key in header `x-api-key`

Returns Google Play reviews for an app by `app_id`. `sort` is `newest` (default), `helpfulness` or `rating`, and `num` is up to 1000 per request (default 100). Each review has its text, score, date, thumbs-up count, app version and any developer reply. Pass `next_pagination_token` back to continue.

## Query parameters

- `app_id` string, required
- `sort` 'helpfulness' | 'newest' | 'rating'
- `num` integer
- `country` string
- `lang` string
- `paginate` boolean
- `next_pagination_token` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleplayReviewsResponseDoc
  - `code` integer
  - `data` GoogleplayReviewsResult
    - `data` GoogleplayReview[]: Reviews on this page, newest or sorted as requested.
      - `criterias` GoogleplayReviewCriteria[]: Per-criterion ratings attached to the review, when Google Play shows them.
        - `criteria` string: Name of the aspect being rated, such as `Accuracy`.
        - `rating` integer: Rating given for this aspect. `null` when no rating is shown.
      - `date` string: Time the review was posted, in UTC (RFC 3339).
      - `id` string: Google Play review ID.
      - `reply_date` string: Time the developer replied, in UTC (RFC 3339).
      - `reply_text` string: Developer's reply to the review. `null` when there is no reply.
      - `score` integer: Star rating the reviewer gave, from 1 to 5.
      - `score_text` string: Star rating as a string, such as `5`.
      - `text` string: Body text of the review.
      - `thumbs_up` integer: Number of users who marked the review as helpful.
      - `title` string: Review headline. Currently always `null`.
      - `url` string: Google Play link to this review.
      - `user_image` string: URL of the reviewer's profile picture.
      - `user_name` string: Display name of the reviewer.
      - `version` string: App version the review was written for. `null` when not shown.
    - `next_pagination_token` string: Token to pass as `next_pagination_token` to fetch the next page of reviews.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)