Allegro

Allegro Product Offers API (all sellers)

Every seller's offer for one Allegro catalogue product: the price comparison page, 60 offers per page on allegro.pl, allegro.cz, allegro.sk or allegro.hu, sortable by price or price including delivery and filterable by condition, price range and Allegro Smart!. Each offer has price, price with delivery, delivery estimate, condition, seller (login, super seller, positive feedback percent and count, business or private), Smart! flag, stock where shown, placement (sponsored and promoted flagged) and is_featured for the buy box offer. Also the exact total and total pages. The job behind Allegro price monitoring and repricing. Costs 2 credits per request.

POST/api/v1/allegro/product-offers

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

product_idstring

A catalogue product id (a uuid): items[].product_id of a search or product_id of an offer. Send product_id or url.

Example: 90d08230-e02a-4210-913d-d417453321b8

urlstring

A product link (allegro.pl/produkt/..., or the product's offers page), on any of the four sites. Alternative to product_id.

Example: https://allegro.pl/produkt/lego-city-kalendarz-adwentowy-na-2026-rok-prezent-dla-5-latka-60510-90d08230-e02a-4210-913d-d417453321b8

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.

pageinteger

Results page, 1-based, up to 100. Defaults to 1. 60 organic offers per page; sponsored slots come on top of them.

Example: 2

sortenum<string>default:relevance

The order of the offers. Sponsored slots are not sorted; the promoted block and the regular block are each in sort order.

relevance — The site's own order. The default.
price_low_to_high — Cheapest first.
price_high_to_low — Most expensive first.
price_with_delivery_low_to_high — Cheapest including delivery first.
price_with_delivery_high_to_low — Most expensive including delivery first.
popularity — Most popular first.

min_pricenumber

Lowest price, in the site's currency.

Example: 500

max_pricenumber

Highest price, in the site's currency.

Example: 2000

conditionenum<string>

Only new or only used offers.

Example: used

new — New items.
used — Used items (the site's used value, not its wider group that also holds items for renovation).

smartboolean

Only offers with Allegro Smart! (free delivery and returns for members).

Example: true

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Every seller's price for one product, cheapest delivered first. Run it on a
# schedule and store each answer: that is your Allegro price history.
pid = "90d08230-e02a-4210-913d-d417453321b8"
res = client.allegro.product_offers(product_id=pid, sort="price_with_delivery_low_to_high", condition="new")["data"]
print(res["total"], "offers")
for o in res["offers"]:
    if o["is_sponsored"]:
        continue
    print(o["seller"]["login"], o["price"], o["price_with_delivery"], o["smart"], "buy box" if o["is_featured"] else "")

Response

"product_id": "90d08230-e02a-4210-913d-d417453321b8",

"title": "LEGO City Kalendarz adwentowy na 2026 rok, prezent dla 5-latka 60510",

"sort": "relevance",

"applied_filters": {},

"total": 407,

"total_pages": 7,

"page": 1,

"page_size": 60,

"count": 61,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 4106

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Every seller's price for one product, cheapest delivered first. Run it on a # schedule and store each answer: that is your Allegro price history. pid = "90d08230-e02a-4210-913d-d417453321b8" res = client.allegro.product_offers(product_id=pid, sort="price_with_delivery_low_to_high", condition="new")["data"] print(res["total"], "offers") for o in res["offers"]: if o["is_sponsored"]: continue print(o["seller"]["login"], o["price"], o["price_with_delivery"], o["smart"], "buy box" if o["is_featured"] else "")