Media Expert
Media Expert Category API
One Media Expert category's products by path, 30 a page (up to 50), with price, old price, the Omnibus 30-day low, the code price with its code and dates, seller and availability, Media Expert's facets as filters (brand, promotions such as Cena z kodem and Black Weeks, specifications, marketplace sellers) and ten sorts. A parent category answers with its subcategories. Costs 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/jsoncategorystringrequiredA category path (categories[].path, breadcrumbs[].path) or its mediaexpert.pl link.
Example: agd/pralki-i-suszarki/pralki
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 unsorted, 3 credits with a sort or when Media Expert loads the page lazily (one more lookup for the rest of the page). 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)
# Samsung washing machines with a code price: 1 credit a page unsorted.
data = client.mediaexpert.category(category="agd/pralki-i-suszarki/pralki",
filters=["samsung", "promocje_cena-z-kodem"])["data"]
for i in data["items"]:
print(i["product_id"], i["price"], i["omnibus_lowest_30d"], i["code_price"])Response