# Allegro Reviews API Documentation

<p><strong>Allegro Reviews API Documentation</strong> List the reviews of one Allegro product. Send the product_id from a search or offer result. Every review has the rating, text, pros, cons, images, the date in ISO 8601, helpful votes and the seller. The answer also holds the total count and the most mentioned product features. Filter by rating from 1 to 5. A page past the last page returns an empty list. Cost: 1 credit per request, only for successful requests with results. Failed and empty requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/allegro-api/allegro_reviews](https://scrappa.co/docs/allegro-api/allegro_reviews)
- **API group:** Allegro API
- **Endpoint:** `GET https://scrappa.co/api/allegro/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 | Product UUID from a search or offer result (product_id), for example 22402d16-c94f-419c-a9d7-6f5aa02ed9a5. |
| `page` | integer | No | Page number from 1. 20 reviews per page. A page past the last page returns an empty list. |
| `rating` | integer | No | Whole number 1 to 5. Returns only reviews with this rating. |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "id": "624d54214c83d2711b4d6d53",
                "cons": "Cena,  brak mo\u017cliwo\u015bci ustawiania dowolnie ikon,  konieczno\u015b\u0107 aktywacji Apple Pay aby u\u017cy\u0107 NFC",
                "pros": "Aparat,  bateria,  faceID,  dobry d\u017awi\u0119k,  \u015bwietny wy\u015bwietlacz,  szybko\u015b\u0107 dzia\u0142ania,  wyko\u0144czenie",
                "text": "Mimo pocz\u0105tkowych w\u0105tpliwo\u015bci po przesiadce z Androida, jestem ca\u0142kiem zadowolona. 13stka dzia\u0142a szybko i prezentuje si\u0119 bardzo dobrze. Aparat to zdecydowany plus tego modelu. Po androidzie najbardziej boli brak mo\u017cliwo\u015bci dostosowania sobie uk\u0142adu ikon na ekranie. Ale sam interface jest do\u015b\u0107 udany, wiec pewnie to kwestia przyzwyczajenia. Bateria spokojnie wytrzyma 2 dni przy do\u015b\u0107 intensywnym u\u017cyciu .",
                "author": "K...0",
                "images": [],
                "rating": 5,
                "is_best": true,
                "language": "pl-PL",
                "created_at": "2022-04-06T08:49:37Z",
                "seller_login": "Allegro",
                "helpful_count": 6,
                "not_helpful_count": 4
            }
        ],
        "features": [
            {
                "label": "Jako\u015b\u0107 wykonania",
                "mentions": 12,
                "sentiment": "positive",
                "negative_mentions": 1,
                "positive_mentions": 11
            },
            {
                "label": "Wydajno\u015b\u0107",
                "mentions": 10,
                "sentiment": "positive",
                "negative_mentions": 2,
                "positive_mentions": 8
            }
        ],
        "pagination": {
            "has_next": true,
            "total_pages": 4,
            "current_page": 1,
            "total_results": 69
        },
        "product_id": "86530fbb-7c5a-41cc-92e2-6d622aa75509",
        "rating_filter": null
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No product has this id. This response is not billable. |
| 502 | Upstream Unavailable | Allegro did not answer in time or blocked the lookup. Retry. This response is not billable. |

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