> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get App Reviews

> User reviews from Apple RSS feed

```
GET /v1/apps/:id/reviews
```

Fetches user reviews from Apple's public RSS feed. Returns up to 50 reviews per page, with a maximum of 10 pages (500 reviews total per country).

## Path Parameters

| Name | Type   | Required | Description                                                                              |
| ---- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| id   | string | Yes      | App ID — numeric for Apple (`1617391485`), package name for Google (`com.spotify.music`) |

## Query Parameters

| Name     | Type   | Default      | Description                                                                      |
| -------- | ------ | ------------ | -------------------------------------------------------------------------------- |
| platform | string | `apple`      | `apple` (default) or `google` for Google Play — see [Platforms](/docs/platforms) |
| country  | string | `us`         | ISO country code (e.g. `us`, `gb`, `jp`)                                         |
| page     | number | `1`          | Page number (1–10)                                                               |
| sortBy   | string | `mostRecent` | Sort order: `mostRecent` or `mostHelpful`                                        |
| lang     | string | `en`         | Google Play language code (used when `platform=google`)                          |

## Code Examples

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X GET "https://api.appeeky.com/v1/apps/1617391485/reviews?country=us&page=1&sortBy=mostRecent" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const response = await fetch(
    "https://api.appeeky.com/v1/apps/1617391485/reviews?country=us&page=1&sortBy=mostRecent",
    {
      headers: {
        "X-API-Key": "YOUR_API_KEY",
      },
    }
  );

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  response = requests.get(
      "https://api.appeeky.com/v1/apps/1617391485/reviews",
      params={"country": "us", "page": 1, "sortBy": "mostRecent"},
      headers={"X-API-Key": "YOUR_API_KEY"},
  )

  data = response.json()
  print(data)
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "appId": "1617391485",
    "reviews": [
      {
        "author": "PuzzleFan92",
        "rating": 5,
        "title": "Best puzzle game ever!",
        "content": "I've been playing this for months. The levels are challenging but fair, and the design is beautiful. Highly recommended for anyone who loves block puzzles.",
        "date": "2026-02-10T12:00:00Z"
      },
      {
        "author": "CasualGamer_Jake",
        "rating": 4,
        "title": "Fun but too many ads",
        "content": "Great gameplay and very addictive, but the ads between levels are a bit much. Would happily pay to remove them if that was an option.",
        "date": "2026-02-09T08:30:00Z"
      },
      {
        "author": "iPhoneUser2024",
        "rating": 2,
        "title": "Crashes after latest update",
        "content": "The app keeps crashing after the latest update on my iPhone 14. Was working perfectly before. Please fix this ASAP.",
        "date": "2026-02-08T15:45:00Z"
      }
    ],
    "hasMore": true,
    "page": 1
  }
}
```

## Review Object

| Field   | Type   | Description                                          |
| ------- | ------ | ---------------------------------------------------- |
| author  | string | Reviewer display name                                |
| rating  | number | Star rating (1–5)                                    |
| title   | string | Review title / headline                              |
| content | string | Review body text (only reviews with written content) |
| date    | string | Review date (ISO 8601)                               |

## Pagination

| Field   | Type    | Description                        |
| ------- | ------- | ---------------------------------- |
| hasMore | boolean | `true` if more pages are available |
| page    | number  | Current page number                |

Apple's RSS feed provides a maximum of **10 pages** with up to **50 reviews per page**, giving a ceiling of **500 reviews** per country.

<Note>
  **Sort options:**

  * `mostRecent` — Returns the newest reviews first. Best for monitoring recent user sentiment and catching new issues.
  * `mostHelpful` — Returns reviews that other users found most helpful. Best for understanding the most impactful feedback.

  Reviews without written content are automatically filtered out. The first entry in Apple's RSS feed (app summary) is also excluded.
</Note>

<Tip>
  **Filtering strategies:** To analyze reviews effectively, consider:

  * Paginate through all 10 pages to get a comprehensive view (up to 500 reviews)
  * Use `mostRecent` to track sentiment after an app update
  * Use `mostHelpful` to surface the most impactful user feedback
  * Combine with different `country` codes to compare regional sentiment
  * Filter by `rating` on the client side to focus on negative reviews (1–2 stars) or positive ones (4–5 stars)
</Tip>

## Errors

| Status | Code              | When                           |
| ------ | ----------------- | ------------------------------ |
| 400    | INVALID\_APP\_ID  | Non-numeric or missing app ID  |
| 400    | INVALID\_PAGE     | Page number outside 1–10 range |
| 401    | MISSING\_API\_KEY | No API key in the request      |
| 401    | INVALID\_API\_KEY | Invalid or expired API key     |