Media Expert
Media Expert Brand API
One brand's products on Media Expert, across the store or inside one category, 30 a page (up to 50), with price, old price, the Omnibus 30-day low, the code price, seller and availability, facets as filters (including which marketplace sellers carry the brand) and ten sorts. Take the brand from brands[].slug. 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/jsonbrandstringrequiredA brand: brands[].slug (e.g. samsung, amica) or its mediaexpert.pl/<brand> link.
Example: amica
categorystringOnly this brand inside one category path (e.g. agd/pralki-i-suszarki/pralki).
Example: telewizory-i-rtv/telewizory
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)
# Every Amica product, page by page: 1 credit a page unsorted.
page = 1
while True:
data = client.mediaexpert.brand(brand="amica", page=page, limit=50)["data"]
for i in data["items"]:
print(i["product_id"], i["name"], i["price"], i["code_price"])
if not data["has_more"]:
break
page += 1Response