Allegro

Allegro Seller Offers API

One Allegro seller's offers by login on allegro.pl, allegro.cz, allegro.sk or allegro.hu: the seller (id, login, business or private), whether the seller is active, the categories the seller sells in with offer counts and a slug to filter by, and the seller's offers, 60 per page, with the search sorts and filters and an optional query within the seller's offers. Each offer has the search listing fields: price, price with delivery, discount with the 30-day lowest price, sold count, Smart! flag and placement. Super seller status and the feedback score come from seller-feedback. Costs 2 credits per request.

POST/api/v1/allegro/seller

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

loginstringrequired

A seller login (2-64 characters: letters, digits, dot, underscore, hyphen): items[].seller.login of a search or seller.login of an offer.

Example: Yupilo_pl

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 seller's offers, 1-200 characters.

Example: lenovo

categorystring

Only one of the seller's categories: categories[].slug of a previous seller answer (e.g. komputery).

Example: komputery

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

# A competitor's whole catalogue, page by page, with price and sales signal.
login, page, offers = "Yupilo_pl", 1, []
while True:
    res = client.allegro.seller(login=login, page=page)["data"]
    offers += res["items"]
    if page >= res["total_pages"]:
        break
    page += 1
print(len(offers), "of", res["total"], "offers in", [c["name"] for c in res["categories"]])

Response

"login": "Yupilo_pl",

"is_active_seller": true,

"query": null,

"category": null,

"sort": "relevance",

"applied_filters": {},

"total": 174,

"total_pages": 3,

"page": 1,

"page_size": 60,

"count": 60,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 4072

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # A competitor's whole catalogue, page by page, with price and sales signal. login, page, offers = "Yupilo_pl", 1, [] while True: res = client.allegro.seller(login=login, page=page)["data"] offers += res["items"] if page >= res["total_pages"]: break page += 1 print(len(offers), "of", res["total"], "offers in", [c["name"] for c in res["categories"]])