Media Expert
Media Expert Outlet API
Media Expert's outlet (ex-display, returned and end-of-line items at outlet prices): without category, the outlet's groups with product counts; with an outlet group path, its subgroups or its products, 30 a page, with the outlet price, the price before it (old_price), the Omnibus 30-day low and the usual filters and sorts. Costs 1 credit for the groups; products 1 credit unsorted, 3 with a sort or a lazily loaded page.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncategorystringAn outlet group path (subcategories[].path). Without it, the outlet's groups.
Example: outlet/outlet-agd/outlet-lodowki-wolnostojace
filtersstring | string[]Up to 10 filters: facets[].values[].filter from an earlier answer (brand, promotions such as Cena z kodem or Black Weeks, Top Hit, instalments, energy class, specifications, marketplace seller). Several filters narrow together. There is no price filter.
Example: ["samsung", "promocje_cena-z-kodem"]
sortenum<string>default:relevanceResult order. Any sort costs 3 credits: Media Expert loads sorted lists lazily.
Example: price_asc
relevance— Media Expert's own order (default).price_asc— Price low to high, in Media Expert's own order: it follows promotional and code prices, so it is approximate against price. Re-sort the page if you need a strict order.price_desc— Price high to low, Media Expert's own order (approximate, as above).rating— Customer rating.newest— Newest first.name_asc— Name A-Z.name_desc— Name Z-A.brand_asc— Brand A-Z.brand_desc— Brand Z-A.discount— Biggest discount first, as Media Expert orders it.
pageintegerdefault:1Page, 1 to 100 (total_pages says how deep the list goes).
Example: 2
limitintegerdefault:30Products per page: 5, 10, 15, 20, 30 or 50, the page sizes Media Expert offers.
Example: 50
Notes
Store. One store: mediaexpert.pl, Poland, prices in PLN. There is no country input: Media Expert runs one Polish storefront. Names, specifications, labels, store names and review text come back in Polish, as Media Expert writes them; field names are English. Cost: 1 credit for the outlet's groups; an outlet group's products cost 1 credit unsorted, 3 with a sort or when Media Expert loads the page lazily. Billing is the actual cost of the call, and every answer reports it in credits_used.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Walk the outlet: groups first, then the products of one leaf group.
groups = client.mediaexpert.outlet()["data"]["subcategories"]
print([(g["name"], g["product_count"]) for g in groups])
data = client.mediaexpert.outlet(category="outlet/outlet-agd/outlet-lodowki-wolnostojace")["data"]
for i in data.get("items", []):
print(i["name"], i["price"], i["old_price"])Response