Allegro

Allegro Offer Details API

One Allegro offer (one seller's listing, /oferta/) by offer number or link, on allegro.pl, allegro.cz, allegro.sk or allegro.hu: title, condition, price, original price and the 30-day lowest price with the discount, price with delivery, units in stock, sold count, auction state (current price, minimum next bid, bid step, end time, whether anyone has bid) or buy now price, every parameter (EAN / GTIN, brand, model...), the seller's description as plain text, images, breadcrumb, delivery methods with price and estimated delivery, handling time, returns, warranty, the product's rating and offer count, and the seller (login, super seller, positive feedback percent and counts, business or private, company name for business sellers). Costs 2 credits per request.

POST/api/v1/allegro/offer

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

offer_idstring | integer

An offer number (8-14 digits): items[].offer_id of a search, category or seller answer. Send offer_id or url.

Example: 18801787032

urlstring

An offer link (allegro.pl/oferta/..., or a product link with ?offerId=), on any of the four sites. Alternative to offer_id.

Example: https://allegro.pl/oferta/laptop-hp-stream-14-17858046919

countryenum<string>default:pl

The Allegro site. Titles, parameters, labels and facet names come back in the site's language (Polish on pl), prices in its currency. When you send a url, the market follows the url; a url on one site with a different country is a 400.

Example: pl

pl — allegro.pl, PLN, Polish. The default, and the only market with the buying_format and deals filters.
cz — allegro.cz, CZK, Czech.
sk — allegro.sk, EUR, Slovak. Calls can take up to about 60 seconds.
hu — allegro.hu, HUF, Hungarian. Calls can take up to about 60 seconds.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

offer = client.allegro.offer(offer_id="18801787032")["data"]
print(offer["title"], offer["price"], offer["currency"], "with delivery", offer["price_with_delivery"])
if offer["lowest_price_30d"]:
    print("30-day lowest before the discount:", offer["lowest_price_30d"], f"-{offer['discount_percent']}%")
s = offer["seller"]
print(s["login"], "super seller" if s["super_seller"] else "", s["positive_feedback_percent"], s["company_name"])

Response

"offer_id": "18801787032",

"product_id": "42a995a2-04ad-4a0e-9047-d24b2400cbe0",

"title": "Laptop Acer Aspire Lite 15,6 FHD Celeron N4500 8GB SSD256GB Intel Graphics",

"url": "https://allegro.pl/oferta/laptop-acer-aspire-lite-15-6-fhd-celeron-n4500-8gb-ssd256gb-intel-graphics-18801787032",

"product_url": "https://allegro.pl/produkt/laptop-acer-aspire-lite-15-6-fhd-celeron-n4500-8gb-ssd256gb-intel-graphics-42a995a2-04ad-4a0e-9047-d24b2400cbe0",

"status": "active",

"condition": "Nowy",

"price": 1357.02,

"currency": "PLN",

"buy_now": true,

"buy_now_price": null,

"original_price": 1399,

"lowest_price_30d": 1399,

"lowest_price_30d_note": "Najniższa cena oferty z 30 dni przed obniżką, obowiązuje do 30.11.2026 lub wyczerpania zapasów",

"discount_percent": 3,

"discount_amount": 41.98,

"price_with_delivery": 1367.51,

"stock": 42,

"stock_label": "z 42 sztuk",

"sold_count": 3,

"sold_label": "3 osoby kupiły 3 sztuki",

"is_auction": false,

"auction": null,

"gtin": null,

"brand": "Acer",

"description": "Laptop Acer Aspire Lite 15 Poznaj Aspire Lite 15 – laptopa, który stawia na prostotę bez kompromisów. Zaprojektowany z myślą o łatwym użytkowaniu laptop jest wyposażony we wszystkie niezbędne funkcje potrzebne do utrzymania łączności i produktywności.",

"handling_time": "24 godziny",

"rating": 5,

"rating_count": 1,

"product_offers_count": 2,

"smart": true,

"country": "pl",

"language": "pl"

"response_time": 3978

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") offer = client.allegro.offer(offer_id="18801787032")["data"] print(offer["title"], offer["price"], offer["currency"], "with delivery", offer["price_with_delivery"]) if offer["lowest_price_30d"]: print("30-day lowest before the discount:", offer["lowest_price_30d"], f"-{offer['discount_percent']}%") s = offer["seller"] print(s["login"], "super seller" if s["super_seller"] else "", s["positive_feedback_percent"], s["company_name"])