Allegro

Allegro Search API

Search Allegro, the largest marketplace in Poland and Central Europe, by keyword on allegro.pl (PLN), allegro.cz (CZK), allegro.sk (EUR) and allegro.hu (HUF). Sort by price, price with delivery, popularity, ending soonest or newest; filter by price range, new or used, Allegro Smart!, and on allegro.pl buy now vs auction and the deals zone; optionally inside one category. 60 organic offers per page with offer id, catalogue product id, price, price with delivery, condition, auction state, discount with the 30-day lowest price, seller (super seller, positive feedback percent, business or private), rating, sold count, Smart! flag and placement (sponsored and promoted flagged), plus the exact total and every facet. Titles come in the site's language. Costs 2 credits per request.

POST/api/v1/allegro/search

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

querystringrequired

Search keywords, 1-200 characters, in any language. Misspellings are not corrected: results are what the site matches.

Example: laptop

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.

category_idstring | integer

Search inside one category: a category id (category.id or breadcrumb[].id of an offer, e.g. 491 = laptops) or its slug (laptopy-491).

Example: 491

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 listing. Sponsored slots are not sorted; where the site shows promoted offers as their own block, each block is 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.
ending_soonest — Auctions first to end first.
newest — Newest offers 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).

buying_formatenum<string>

pl only: buy now (fixed price) or auction offers. A 400 on cz, sk and hu.

Example: auction

buy_now — Fixed-price offers.
auction — Auctions.

smartboolean

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

Example: true

dealsboolean

pl only: only offers in Allegro's deals and promotions zone, seasonal campaign deals included (Black Weeks while it runs). A 400 on cz, sk and hu.

Example: true

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Used Nike shoes on allegro.pl, cheapest first, sponsored slots skipped.
res = client.allegro.search(query="buty nike", condition="used", sort="price_low_to_high")["data"]
print(res["total"], "matches")
for item in res["items"]:
    if item["is_sponsored"]:
        continue
    print(item["offer_id"], item["price"], item["currency"], item["seller"]["login"], item["title"])

Response

"query": "laptop",

"category_id": null,

"sort": "relevance",

"applied_filters": {},

"total": 1173947,

"total_pages": 100,

"page": 1,

"page_size": 60,

"count": 73,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 3823

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Used Nike shoes on allegro.pl, cheapest first, sponsored slots skipped. res = client.allegro.search(query="buty nike", condition="used", sort="price_low_to_high")["data"] print(res["total"], "matches") for item in res["items"]: if item["is_sponsored"]: continue print(item["offer_id"], item["price"], item["currency"], item["seller"]["login"], item["title"])