# Apple Podcasts Ratings API Documentation

<p>Read the public rating, rating count and the review texts Apple ships on the show page for a collection id and storefront. Add a page number from 1 to 10 to read the deeper customer review feed instead. Ratings and counts are numbers and dates are ISO 8601. An unknown id or a page with no reviews is a free 404. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_ratings](https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_ratings)
- **API group:** Apple Podcasts API
- **Endpoint:** `GET https://scrappa.co/api/apple-podcasts/ratings`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Numeric collection id from search. |
| `country` | string | No | Storefront: us or de, default us. |
| `page` | integer | No | Review page 1 to 10. When set, the deep review feed is returned. |

## Example response

```json
{
    "data": {
        "id": "1200361736",
        "rating": 4.5,
        "country": "US",
        "reviews": [
            {
                "date": "2026-01-01T00:00:00+00:00",
                "text": "Loved it",
                "title": "Great",
                "rating": 5
            }
        ],
        "rating_count": 320,
        "review_count": 10
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "ratings"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No show has this id. Not billed. |

## 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)
