---
title: "Get Google Play ratings by device"
method: GET
path: "/googleplay/ratings"
tags: ["GooglePlay"]
---

# Get Google Play ratings by device

`GET /googleplay/ratings`

## Request

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

Returns the ratings-and-reviews breakdown Google Play shows under the details page's device tabs, one entry each for phone, tablet, and Chromebook. Defaults: `country=us`, `lang=en`.

## Query parameters

- `app_id` string, required
- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleplayRatingsResponseDoc
  - `code` integer
  - `data` GoogleplayDeviceRating[]
    - `device` string: Device type the rating breakdown covers: `phone`, `tablet` or `chromebook`.
    - `histogram` object: Number of ratings at each star level on this device type, keyed `1` to `5`.
    - `ratings` integer: Total number of star ratings on this device type.
    - `reviews` integer: Total number of written reviews on this device type.
    - `score` number: Average star rating on this device type, out of 5.
    - `score_text` string: Average rating on this device type as Google Play displays it, such as `4.7`.
  - `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/0497899e2016?raw)