Allegro Reviews API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Product UUID from a search or offer result (product_id), for example 22402d16-c94f-419c-a9d7-6f5aa02ed9a5.
1234567890
integer
Optional
Page number from 1. 20 reviews per page. A page past the last page returns an empty list.
1
integer
Optional
Whole number 1 to 5. Returns only reviews with this rating.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"product_id": [
"The product_id is the product UUID from a search or offer result."
]
},
"message": "The request validation failed"
}Not Found
No product has this id. This response is not billable.
{
"meta": {
"billable": false
},
"error": {
"code": "NOT_FOUND",
"message": "Allegro has no product with this id."
},
"success": false
}Upstream Unavailable
Allegro did not answer in time or blocked the lookup. Retry. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Allegro is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.