ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/mediaexpert/promotions

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
liststring

One 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

querystring

Only lists whose name or reference contains this text (without list).

Example: lego

black_weeksboolean

Only Black Weeks / Black Friday lists (without list).

Example: true

sortenum<string>default:relevance

Result 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:1

Page, 1 to 100 (total_pages says how deep the list goes). With list only.

Example: 2

limitintegerdefault:30

Products 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

"query": null,
"black_weeks": true,
"total_lists": 20,
"count": 3,
},
"response_time": 8182
}
PreviousMedia Expert BrandNextMedia Expert Outlet
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy