Media Expert
Media Expert Promotions API
Media Expert's promotion lists, Black Weeks included: without list, the lists its promotions page links, with their names and whether each is a Black Weeks list; with list, that list's products, 30 a page, with price, old price, the Omnibus 30-day low and the code price with its code and dates. Costs 1 credit for the lists; a list's 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/jsonliststringOne promotion list: lists[].list or its mediaexpert.pl/lista,... link (the id alone is not enough). Without it, the promotion lists.
Example: 32975-logitech-black-weeks-czas-na-nowy-poziom-sprzetu
querystringOnly lists whose name or reference contains this text (without list).
Example: lego
black_weeksbooleanOnly Black Weeks / Black Friday lists (without list).
Example: true
sortenum<string>default:relevanceResult order. Any sort costs 3 credits: Media Expert loads sorted lists lazily. With list only.
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). With list only.
Example: 2
limitintegerdefault:30Products per page: 5, 10, 15, 20, 30 or 50, the page sizes Media Expert offers. With list only.
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. Every product, in any list, also carries its own promotion data (old_price, omnibus_lowest_30d, code_price), so search, category and brand read promotions too; the promotions facet filters them. Cost: 1 credit for the promotion lists; a list'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)
# Every Black Weeks list, then each list's products with their code prices.
lists = client.mediaexpert.promotions(black_weeks=True)["data"]["lists"]
for l in lists:
data = client.mediaexpert.promotions(list=l["list"])["data"]
for i in data["items"]:
print(l["name"], i["name"], i["price"], i["omnibus_lowest_30d"], i["code_price"])Response