docs / allegro

Allegro API scraper

base /allegro/v15 endpoints

post/allegro/v1/search2 credits

Search Allegro by keyword — returns offer cards with title, price (PLN), delivery cost, seller, rating, photos and offer URL. Supports price range, condition, free-delivery, sort and category filters, with page pagination.

Parameter		Allowed / range	Description
query	required	—	What to search for (offer keywords, Polish or any language).
max_pages = 1	optional	1–10	How many result pages to fetch (1–10). Each page ≈ 60 offers.
sort = relevance	optional	relevance · price_asc · price_desc · popularity · newest	Result ordering.
min_price	optional	—	Minimum price filter, in PLN.
max_price	optional	—	Maximum price filter, in PLN.
condition	optional	new · used	Item condition filter.
free_delivery	optional	—	Only offers with free delivery (darmowa dostawa).
category	optional	—	Restrict to an Allegro category slug (the slug in a category URL, e.g. telefony-komorkowe-165).

Try in playground →

post/allegro/v1/category2 credits

Browse an Allegro category without a keyword (the /kategoria/<slug> grid) — discover popular offers in a category. Supports price/condition/free-delivery/sort filters and page pagination.

Parameter		Allowed / range	Description
category	required	elektronika · moda · dom-i-ogrod · dziecko · kultura-i-rozrywka · motoryzacja · sport-i-turystyka · zdrowie · uroda · supermarket	Allegro category to browse — a top-level slug below, or any category slug from a category URL (e.g. telefony-komorkowe-165).
max_pages = 1	optional	1–10	How many category pages to fetch (1–10).
sort = relevance	optional	relevance · price_asc · price_desc · popularity · newest	Result ordering.
min_price	optional	—	Minimum price filter, in PLN.
max_price	optional	—	Maximum price filter, in PLN.
condition	optional	new · used	Item condition filter.
free_delivery	optional	—	Only offers with free delivery.

Try in playground →

post/allegro/v1/offer2 credits

Single Allegro offer/product detail by id or URL — title, price (PLN), main image and gallery, seller handle, and description.

Parameter		Allowed / range	Description
offer_id	optional	—	Allegro offer id — the digits in an offer URL (allegro.pl/oferta/<id>). Provide offer_id OR offer_url.
offer_url	optional	—	Full offer/product URL — alternative to offer_id.

Try in playground →

post/allegro/v1/seller_offers2 credits

A seller's public active listings, paginated — every offer a seller (shop) has live. Provide the seller login (handle from a seller URL / a search result's seller.login).

Parameter		Allowed / range	Description
seller	required	—	Allegro seller login/handle (from allegro.pl/uzytkownik/<login> or a search result's seller.login).
max_pages = 1	optional	1–10	How many of the seller's listing pages to fetch (1–10).
sort = relevance	optional	relevance · price_asc · price_desc · newest	Order within the seller's listings.

Try in playground →

post/allegro/v1/suggested2 credits

Related/recommended Allegro offers for a keyword — a quick set of relevant offers (the first result page) useful for 'more like this' / market discovery.

Parameter		Allowed / range	Description
query	required	—	Keyword to fetch related offers for.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/allegro/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 15"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}