# Apple App Store Product Reviews

Apple product reviews endpoint across verticals: app reviews, book reviews, podcast reviews, and the Rotten Tomatoes critics block for movies/TV. End of review history is a normal, successful completion (end_of_history=true).

- **Documentation:** [https://scrappa.co/docs/apple-app-store-api/apple_app_store_product_reviews](https://scrappa.co/docs/apple-app-store-api/apple_app_store_product_reviews)
- **API group:** Apple App Store API
- **Endpoint:** `GET https://scrappa.co/api/apple/app-store/product/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_id` | string | Yes | Apple product id (numeric adam id, e.g. 284882215; UMC ids also accepted for movies/TV). |
| `store` | string | No | Apple store vertical: apps, mac, books, audiobooks, movies, tv, music, or podcasts. |
| `country` | string | No | Two-letter Apple storefront country code (e.g. us, gb, de). Defaults to us. |
| `season_id` | string | No | TV season id; returns the season product instead of the show. |
| `num` | integer | No | Requested review result count per page. |
| `next_page_token` | string | No | Review pagination token from a previous response. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/apple/app-store/product/reviews?product_id=284882215&store=apps&num=20"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "apple_app_store_details",
        "product_id": "284882215",
        "store": "apps",
        "country": "us"
    },
    "product": {
        "id": "284882215",
        "store": "apps",
        "title": "Facebook",
        "artist": "Meta Platforms, Inc.",
        "rating": 2.3,
        "rating_count": 1300000,
        "content_rating": "12+"
    },
    "ratings": {
        "rating_average": 2.3,
        "rating_count": 1300000,
        "histogram": {
            "1": 500000,
            "2": 100000,
            "3": 150000,
            "4": 200000,
            "5": 350000
        }
    },
    "reviews": [
        {
            "id": "10086435917",
            "title": "Great app",
            "author": "reviewer",
            "rating": 5,
            "text": "Works well.",
            "date": "2026-06-01T00:00:00Z",
            "is_edited": false
        }
    ],
    "reviews_pagination": {
        "offset": 0,
        "limit": 20,
        "next_offset": 20,
        "next_page_token": "20",
        "end_of_history": false
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The product_id or another parameter failed validation. |
| 404 | Apple Product Not Found | The product is legitimately absent in the requested storefront. |
| 503 | Apple Upstream Unavailable | Apple could not be fetched through the configured proxy tiers after the full attempt budget. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)