---
title: "Reviews"
method: GET
path: "/appstore/apps/{app_id}/reviews"
tags: ["iOS Apps"]
---

# Reviews

`GET /appstore/apps/{app_id}/reviews`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/appstore/apps/{app_id}/reviews`
- Auth: none declared

User reviews of a given app.

Reviews are ordered newest first; sort_order only accepts desc.

Required permissions for your API key's user: `appstore.apps`.

## Path parameters

- `app_id` string, required

## Query parameters

- `offset` integer
- `page_size` integer
- `sort_field` 'date'
- `sort_order` 'desc'

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `id` integer, nullable: Review ID.
      - `user_id` integer, nullable: iTunes user ID.
      - `username` string, nullable: iTunes username.
      - `rating` integer, nullable: Star rating (1-5).
      - `version` string, nullable: Version of app the user is reviewing.
      - `date` string, date, nullable: When the user submitted the review.
      - `vote_yes` integer, nullable: Number of users that voted this review as helpful.
      - `vote_no` integer, nullable: Number of users that voted this review as unhelpful.
      - `title` string, nullable: Title of the review.
      - `body` string, nullable: Body of the review.
      - `country_id` string, nullable: Country code of the store the user downloaded the app from.
  - object
    - `errors` object, required

## Other responses

- `403`: Invalid key or insufficient endpoint permissions.
- `404`: No matching object or results.
- `408`: The database query timed out.
- `429`: Concurrent request limit exceeded.
- `500`: Internal API error.

---

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