# idealo Product Reviews API Documentation

List user reviews of one product, 10 per page, in the order idealo returns them. Each review has the author, the date (YYYY-MM-DD), the rating from 1 to 5, title, text, the product variant it refers to and the source. A page with no reviews means the end of the list. has_more is true for a full page.

- **Documentation:** [https://scrappa.co/docs/idealo-api/idealo_reviews](https://scrappa.co/docs/idealo-api/idealo_reviews)
- **API group:** idealo API
- **Endpoint:** `GET https://scrappa.co/api/idealo/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 | idealo product ID from search, for example 200474612. |
| `page` | integer | No | 1-based page. Defaults to 1. |

## Example response

```json
{
    "meta": {
        "duration_ms": 1500,
        "upstream_calls": 2
    },
    "page": 1,
    "reviews": [
        {
            "date": "2024-01-04",
            "text": "Dies ist unser 1. Kaffeevollautomat.",
            "about": "Philips LatteGo 5400 Series EP5443/70",
            "title": "Super Kaffee",
            "author": "Otto.de Kunde",
            "rating": 5,
            "source": "Trustami"
        }
    ],
    "success": true,
    "has_more": true,
    "page_size": 10,
    "product_id": "200474612"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Returned when a required parameter is missing or a value is out of range. No credits are charged. |
| 404 | Not Found | Returned when idealo does not know the product, shop or page. No credits are charged. |
| 503 | Service Unavailable | Returned when idealo could not be read after several attempts. Failed requests are not charged. Try again. |
| 502 | Unexpected Response | Returned when idealo answers with a page this API cannot read. Failed requests are not charged. |

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