Allegro

Allegro Category API

One Allegro category's offers by category id, slug or link on allegro.pl, allegro.cz, allegro.sk or allegro.hu, with the same sorts and filters as search and an optional query, plus the category itself: id, name, url, breadcrumb, and its subcategories or sibling categories with offer counts. 60 organic offers per page with price, price with delivery, discount with the 30-day lowest price, seller, sold count, Smart! flag and placement, the exact total and every facet. Category names and titles come in the site's language. Costs 2 credits per request.

POST/api/v1/allegro/category

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

category_idstring | integer

A category id (e.g. 491 = laptops) or its slug (laptopy-491): breadcrumb[].id of an offer or subcategories[].id of a category answer. Send category_id or url.

Example: 491

urlstring

A category link (allegro.pl/kategoria/..., on any of the four sites). Alternative to category_id.

Example: https://allegro.pl/kategoria/laptopy-491

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.

querystring

Search within the category, 1-200 characters.

Example: star wars

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")

# Walk the category tree: the category, then each subcategory's total.
cat = client.allegro.category(category_id="17865")["data"]
print(cat["category"]["name"], cat["total"])
for sub in cat["category"]["subcategories"]:
    print(sub["id"], sub["name"], sub["count"])

Response

"query": null,

"sort": "relevance",

"applied_filters": {},

"total": 109504,

"total_pages": 100,

"page": 1,

"page_size": 60,

"count": 73,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 5047

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Walk the category tree: the category, then each subcategory's total. cat = client.allegro.category(category_id="17865")["data"] print(cat["category"]["name"], cat["total"]) for sub in cat["category"]["subcategories"]: print(sub["id"], sub["name"], sub["count"])