Allegro Offer API Documentation Read one Allegro offer by url or offer id. The offer has the price and regular price as numbers with currency, the condition, stock, the people who bought it in the last 30 days, the seller with feedback and public company name, every delivery option with price and time, returns and warranty, grouped parameters, GTIN, brand, category path, full size photos, the product rating with its distribution and a preview of the product reviews. Cost: 20 credits 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
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Allegro offer url, for example https://allegro.pl/oferta/16571803677. The url fixes the storefront. Send this or offer_id.
https://example.com/product
string
Optional
Numeric offer id from a search result. Send this or url.
1234567890
string
Optional
Allegro storefront: PL (allegro.pl, PLN), CZ (allegro.cz, CZK) or SK (allegro.sk, EUR). Default PL.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"offer": {
"sku": "16571803677",
"url": "https://allegro.pl/oferta/smartfon-apple-iphone-13-128gb-czerwony-stan-bardzo-dobry-16571803677",
"gtin": "0194252708095",
"sold": {
"text": "2 osoby kupi\u0142y 2 sztuki",
"buyers_last_30_days": 2
},
"brand": "Apple",
"price": {
"amount": 1239,
"currency": "PLN"
},
"stock": {
"label": "z 4 sztuk",
"available": 4,
"purchase_limit": null
},
"title": "Smartfon Apple iPhone 13 128GB Czerwony | Stan: bardzo dobry",
"images": [
"https://a.allegroimg.com/original/11dea8/1a721aa74b82833a8e1758b79b4d/Smartfon-Apple-iPhone-13-128GB-Czerwony-Stan-bardzo-dobry",
"https://a.allegroimg.com/original/116753/d0c252e34c17a7ef3b5c87915bbe/Smartfon-Apple-iPhone-13-128GB-Czerwony-Stan-bardzo-dobry-Ladowarka-w-komplecie-nie"
],
"seller": {
"id": "46619855",
"url": "https://allegro.pl/uzytkownik/luxtrade-pl",
"city": "Pszczyna",
"login": "luxtrade-pl",
"is_company": true,
"company_name": "TKBW II SP. Z O.O.",
"country_code": "PL",
"super_seller": false,
"negative_feedback_count": 16,
"positive_feedback_count": 558,
"positive_feedback_percent": 97.2
},
"returns": {
"summary": "Masz 14 dni na odst\u0105pienie od umowy.",
"withdrawal_period": "14 dni"
},
"category": {
"id": "320536",
"name": "iPhone 13"
},
"currency": "PLN",
"delivery": {
"options": [
{
"name": "Allegro One Box, Allegro One",
"group": "Odbi\u00f3r w punkcie",
"price": {
"amount": 10.49,
"currency": "PLN"
},
"free_return": false,
"country_code": "PL",
"delivery_time": "czw. 12 lis. w punkcie",
"next_item_price": {
"amount": 0,
"currency": "PLN"
},
"price_with_smart": {
"amount": 0,
"currency": "PLN"
},
"max_items_per_package": 3
},
{
"name": "Allegro One Punkt, Allegro One",
"group": "Odbi\u00f3r w punkcie",
"price": {
"amount": 10.49,
"currency": "PLN"
},
"free_return": false,
"country_code": "PL",
"delivery_time": "czw. 12 lis. w punkcie",
"next_item_price": {
"amount": 0,
"currency": "PLN"
},
"price_with_smart": {
"amount": 0,
"currency": "PLN"
},
"max_items_per_package": 3
}
],
"cheapest": {
"amount": 0,
"currency": "PLN"
},
"ships_from": "Pszczyna",
"handling_time": "24 godziny",
"ships_from_country_code": "PL"
},
"offer_id": "16571803677",
"warranty": {
"seller_warranty": "Produkt jest obj\u0119ty gwarancj\u0105 sprzedaj\u0105cego przez 24 miesi\u0105ce od zakupu.",
"statutory_warranty": "Sprzedawca odpowiada za wadliwy towar przez 2 lata od jego wydania."
},
"condition": "Powystawowy",
"parameters": [
{
"group": "Dane podstawowe",
"parameters": [
{
"name": "Stan",
"values": [
"Powystawowy"
]
},
{
"name": "Faktura",
"values": [
"Wystawiam faktur\u0119 VAT-mar\u017ca"
]
},
{
"name": "Kod producenta",
"values": [
"MLPJ3PM/A"
]
},
{
"name": "Marka",
"values": [
"Apple"
]
},
{
"name": "Model telefonu",
"values": [
"iPhone 13"
]
},
{
"name": "Typ",
"values": [
"Smartfon"
]
},
{
"name": "EAN (GTIN)",
"values": [
"0194252708095"
]
},
{
"name": "Obs\u0142uga \u0142adowania bezprzewodowego",
"values": [
"tak"
]
}
]
}
],
"product_id": "86530fbb-7c5a-41cc-92e2-6d622aa75509",
"description": "Apple iPhone 13 128 GB\nZosta\u0142 wprowadzony na rynek we wrze\u015bniu 2021 roku. Wyposa\u017cony w aparat, kt\u00f3ry oferuje doskona\u0142e mo\u017cliwo\u015bci fotograficzne, szczeg\u00f3lnie w w...",
"availability": "in_stock",
"listing_type": "buy_now",
"category_path": [
{
"id": "954b95b6-43cf-4104-8354-dea4d9b10ddf",
"name": "Allegro"
},
{
"id": "42540aec-367a-4e5e-b411-17c09b08e41f",
"name": "Elektronika"
},
{
"id": "4",
"name": "Telefony i Akcesoria"
},
{
"id": "165",
"name": "Smartfony i telefony kom\u00f3rkowe"
},
{
"id": "48978",
"name": "Apple"
},
{
"id": "320536",
"name": "iPhone 13"
}
],
"original_price": null,
"product_rating": {
"count": 336,
"average": 4.87,
"distribution": [
{
"count": 318,
"stars": 5
},
{
"count": 7,
"stars": 4
},
{
"count": 3,
"stars": 3
},
{
"count": 1,
"stars": 2
},
{
"count": 7,
"stars": 1
}
]
},
"reviews_preview": [
{
"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
}
],
"discount_percent": null
},
"country": "PL",
"currency": "PLN"
},
"meta": {
"credits": 20,
"billable": true,
"endpoint_family": "offer"
},
"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": {
"url": [
"Send an offer url or an offer_id."
]
},
"message": "The request validation failed"
}Not Found
No offer has this id or it has ended. This response is not billable.
{
"meta": {
"billable": false
},
"error": {
"code": "NOT_FOUND",
"message": "Allegro has no offer 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.