# Allegro Offer API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/allegro-api/allegro_offer](https://scrappa.co/docs/allegro-api/allegro_offer) - **API group:** Allegro API - **Endpoint:** `GET https://scrappa.co/api/allegro/offer` ## 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 | | --- | --- | --- | --- | | `url` | string | No | Allegro offer url, for example https://allegro.pl/oferta/16571803677. The url fixes the storefront. Send this or offer_id. | | `offer_id` | string | No | Numeric offer id from a search result. Send this or url. | | `country` | string | No | Allegro storefront: PL (allegro.pl, PLN), CZ (allegro.cz, CZK) or SK (allegro.sk, EUR). Default PL. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 404 | Not Found | No offer has this id or it has ended. 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)