---
title: "Retrieve App Store reviews"
method: GET
path: "/appstore/reviews"
tags: ["AppStore"]
---

# Retrieve App Store reviews

`GET /appstore/reviews`

## Request

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

Returns one page of customer reviews for an App Store app, identified by `id` (numeric track ID) or `app_id` (bundle ID). `page` runs 1 to 10 and `sort` is `mostRecent` (default) or `mostHelpful`. Reviews carry `score`, `title`, `text`, `version`, `user_name` and `updated`. Returns 503 when reviews cannot be retrieved, and 404 when the app is not in that `country` storefront.

## Query parameters

- `id` string
- `app_id` string
- `country` string
- `page` integer
- `sort` 'mostRecent' | 'mostHelpful'
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AppstoreReviewsResponseDoc
  - `code` integer
  - `data` AppstoreReview[]
    - `id` string: App Store review ID.
    - `score` integer: Rating the reviewer gave the app.
    - `text` string: Text of the review.
    - `title` string: Headline of the review.
    - `updated` string: Date and time the review was last updated, in ISO 8601.
    - `url` string: URL of the review.
    - `user_name` string: Display name of the reviewer.
    - `user_url` string: URL of the reviewer's profile.
    - `version` string: App version the review was written for.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: App not found, or not published in the requested storefront
- `429`: Rate limit exceeded
- `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)