To get Media Expert prices, call Scavio's Media Expert API: POST /api/v1/mediaexpert/product with a product id returns the price, the old price, the Omnibus lowest price of the last 30 days that Media Expert prints next to a promotion, and the code price with its code and dates, for 1 credit; POST /api/v1/mediaexpert/store-stock with the same id and a Polish city or postcode returns the 40 nearest Media Expert stores, each with Media Expert's stock indicator and whether the item can be collected within an hour, for 2 credits. search, category and promotions return the same prices for whole lists.
Media Expert is Poland's consumer-electronics and home-appliance chain, with 618 stores at the end of March 2026 (dlahandlu.pl) and 637 entries in its own store list. Its product pages show up to three prices, the Omnibus line "Najniższa cena z 30 dni przed obniżką", and for each nearby store whether you can pick the item up within an hour ("Odbierz za godzinę"). Media Expert has no public developer API for any of it. Its Black Friday page says Black Friday starts earlier with Black Weeks and falls on 27 November.
Every response below is a trimmed capture from Scavio's Media Expert API on Saturday, November 21, 2026, between 18:08 and 18:26 UTC (19:08 to 19:26 in Poland). Image links are cut from every sample. Prices are numbers in PLN, and names and labels stay in Polish, as Media Expert writes them.
Step 1: Find products with search
Search returns 30 products a page, each with the full price block:
curl -s https://api.scavio.dev/api/v1/mediaexpert/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "iphone 17"}'{
"data": {
"query": "iphone 17",
"category_id": null,
"redirected_to": null,
"sort": "relevance",
"page": 1,
"page_size": 30,
"total": 5000,
"total_capped": true,
"total_pages": 100,
"has_more": true,
"count": 30,
"currency": "PLN",
"items": [
{
"product_id": 8128227,
"offer_id": 2151746557,
"sku": "2095223",
"ean": "0195950643459",
"name": "Smartfon APPLE iPhone 17 5G 256GB 6.3\" 120Hz Czarny",
"brand": "APPLE",
"model": "IPHONE 17",
"price": 4199,
"old_price": 4399,
"omnibus_lowest_30d": 4399,
"code_price": null,
"discount_percent": 5,
"discount_shown": {"amount": 200, "percent": 5},
"currency": "PLN",
"availability": "available",
"availability_label": "Dostępny od ręki",
"rating": 4.9,
"review_count": 216,
"seller": {"id": "0", "name": "Media Expert", "slug": null, "marketplace": false},
"in_store": true,
"warranty_months": 24,
"category": {"category_id": 13170, "name": "Smartfony", "path": "smartfony-i-zegarki/smartfony"}
}
]
},
"credits_used": 3
}Trimmed to 1 of 30 items and some of their fields.
- Ids:
product_idis what the product, store-stock and reviews endpoints take.offer_idis not accepted by them, andskuis Media Expert's product code, the 1-credit way into reviews. - Seller:
seller.marketplaceis true for a third-party marketplace seller. Marketplace items ship from their seller and are never in Media Expert's stores. - Depth: broad searches stop counting at 5,000 (
total_capped) and 100 pages, so narrow with a category. - Credits: a search results page costs 3. Many single Polish words go straight to a category page instead: "telewizor" came back with
redirected_totelewizory-i-rtv/telewizory, 1,017 products, 30 a page, for 1 credit.
Step 2: Read the three prices on one product
Product takes a product_id or a mediaexpert.pl link, 1 credit:
curl -s https://api.scavio.dev/api/v1/mediaexpert/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": 14837388}'{
"data": {
"requested": "14837388",
"product_id": 14837388,
"sku": "2156660",
"ean": "0045496337469",
"name": "Konsola NINTENDO Switch 2 Czarny + Mario Kart World Gra NINTENDO SWITCH 2 + NINTENDO Switch Online 3 miesiące",
"brand": "NINTENDO",
"price": 2799.99,
"old_price": null,
"omnibus_lowest_30d": 2599,
"code_price": {"price": 2499, "code": "BW2011-2611", "valid_from": "2026-11-20T00:00:00+01:00", "valid_to": "2026-11-26T23:59:00+01:00"},
"discount_percent": 11,
"discount_shown": {"amount": 100, "percent": 4},
"currency": "PLN",
"availability": "available",
"availability_label": "Dostępny od ręki",
"seller": {"id": "0", "name": "Media Expert", "slug": null, "marketplace": false, "url": null, "rating": null},
"in_store": true,
"delivery": {"delivery_label": "w poniedziałek", "store_pickup_label": "w poniedziałek", "parcel_locker_label": "2026-11-23", "collect_in_1h": false, "delivery_info": "Dostępny", "min_shipping_price": null},
"installments": {"monthly": 124.95, "months": 20, "interest_rate": 0, "currency": "PLN"},
"first_listed_at": "2026-10-12 11:23:25"
},
"credits_used": 1
}Trimmed: the full answer adds the description, images, key attributes, the specification table, variants, the rating summary, breadcrumbs and related products.
How to read the prices:
priceis what you pay without a code: here 2,799.99 zł.code_priceis the price with a discount code entered at checkout, the code itself and its validity: 2,499 zł with BW2011-2611 until November 26, 23:59.old_priceis Media Expert's struck-through price, when it shows one. Code-price promotions usually have none.omnibus_lowest_30dis the "Najniższa cena z 30 dni przed obniżką" line: 2,599 zł.- Two discounts.
discount_shownis Media Expert's own figure, measured from the 30-day low: 2,599 minus 2,499 is 100 zł, 4%.discount_percentis ours, from the price before the code to the code price: 11%. Use one or the other, never both in one column. delivery.collect_in_1his the product page's own label. For pickup within an hour at a given store, read store-stock (Step 4): this bundle could not be collected within an hour anywhere we checked, and the iPhone 17 could at 238 of 240 stores while its product page said false.
Step 3: Read every code price in a category
Category takes a category path and Media Expert's own filters. The values come from facets[].values[].filter in an earlier answer; promocje_cena-z-kodem is "Cena z kodem", every product with a code price:
curl -s https://api.scavio.dev/api/v1/mediaexpert/category \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category": "telewizory-i-rtv/telewizory", "filters": ["promocje_cena-z-kodem"], "limit": 50, "page": 1}'{
"data": {
"category": "telewizory-i-rtv/telewizory",
"filters": ["promocje_cena-z-kodem"],
"kind": "products",
"title": "Telewizory - PROMOCJE : Cena z kodem",
"page": 1,
"page_size": 50,
"total": 184,
"total_pages": 4,
"has_more": true,
"count": 50,
"items": [
{
"product_id": 10449117,
"ean": "5901292530112",
"name": "Telewizor TCL 98A400 98” QLED 4K 288 Hz VRR Google TV Dolby Atmos Dolby Vision HDMI 2.1",
"price": 9999,
"old_price": null,
"omnibus_lowest_30d": 9999,
"code_price": {"price": 5999, "code": "ME2111-061226", "valid_from": "2026-11-21T00:00:00+01:00", "valid_to": "2026-12-06T23:59:00+01:00"},
"discount_percent": 40,
"discount_shown": {"amount": 4000, "percent": 40},
"availability": "available",
"seller": {"id": "0", "name": "Media Expert", "slug": null, "marketplace": false}
}
]
},
"credits_used": 1
}Trimmed to 1 of 50 items and without facets. An unsorted category page is 1 credit; a sort, or a page Media Expert loads lazily, is 3. On November 21 the four "Cena z kodem" lists we read held 571 products, 13 pages at 50: TVs 184, smartphones 47, laptops 87 and washing machines 253.
To compare each code price with the 30-day low, read the three fields per item:
def compare(item):
low, before, code = item["omnibus_lowest_30d"], item["price"], (item["code_price"] or {}).get("price")
if low is None or code is None:
return None
return {
"before_code_vs_low": "above" if before - low >= 0.005 else "equal" if abs(before - low) < 0.005 else "below",
"code_below_low_zl": round(low - code, 2),
}Across 591 code-price products we read that way, the price before the code was above the 30-day low on 456 (77.2%) and the code price below it on 579 (98.0%), by 1 zł or more on 326. The best Media Expert Black Week price APIs charts it by category.
Step 4: Check store stock near a city or postcode
Store-stock takes a product_id and a location: a Polish city, a town such as Sanok, or a postcode such as 00-950. 2 credits a call:
curl -s https://api.scavio.dev/api/v1/mediaexpert/store-stock \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": 8128227, "location": "Kraków"}'{
"data": {
"product_id": 8128227,
"location": "Kraków",
"count": 40,
"in_stock_count": 40,
"collect_in_1h_count": 40,
"stores": [
{
"store_id": 925,
"name": "Media Expert Kraków, Kapelanka 54, Pasaż Kapelanka",
"code": "S586",
"type": "store",
"address": {"street": "Kapelanka", "house_number": "54", "apartment": null, "postcode": "30-347", "city": "Kraków", "province": "małopolskie"},
"phone": "12 257 11 47",
"latitude": 50.038,
"longitude": 19.92517,
"distance_km": 3.28,
"hours": [{"day": "sunday", "open": "10:00", "close": "18:00"}, {"day": "monday", "open": "09:00", "close": "21:00"}],
"stock_level": 9,
"in_stock": true,
"collect_in_1h": true,
"button_label": "Odbierz za godzinę",
"order_to_store_day": null,
"display_unit": false,
"availability": "available",
"availability_label": "Dostępny"
}
]
},
"credits_used": 2
}Trimmed to 1 of 40 stores and 2 of 7 days. A store without the item on the shelf looks like this, the LG OLED65C54LA at Warszawa Al. Jerozolimskie 148, 4.58 km from the Warszawa point:
{"store_id": 2033, "name": "Media Expert Warszawa, Al. Jerozolimskie 148", "type": "store", "distance_km": 4.58, "stock_level": 0, "in_stock": false, "collect_in_1h": false, "button_label": "Do koszyka", "order_to_store_day": "w poniedziałek", "availability": "available", "availability_label": "Dostępny"}How to read it:
stock_levelis Media Expert's stock indicator, not a unit count. We saw 0, 2, 9 and 20, the buckets Media Expert uses. 0 means none on the shelf.collect_in_1his "Odbierz za godzinę": ready to collect within an hour. In 2,160 store readings it was true exactly when the indicator was above 0.order_to_store_dayis the day an order reaches that store when it is not on the shelf, as Media Expert words it ("w poniedziałek", on Monday), with "Do koszyka" (to basket) on the button.typeisstoreorpickup_point. Small towns list pickup points too: in Sanok the nearest entry was a pickup point 0.49 km away, and the town's store was 2.16 km away.- Errors: an
offer_idis refused before anything is charged; an unknown product id is a charged 404; a marketplace item is a charged 400, because it is never in stores. For a product Media Expert lists as not available, such as the PS5 Pro on November 21, the stores come back with no stock data.
We checked 10 items near Warszawa, Kraków, Gdańsk, Poznań, Wrocław and Sanok. For the 9 items Media Expert listed as available, 1,282 of 2,160 store readings (59.4%) had the item on the shelf; 45 of the 54 item-and-place pairs had a stocked store among the 40, and the median distance to the nearest one was 3.48 km. The iPhone 17, AirPods Pro 3 and a white DualSense were on the shelf almost everywhere; the LG 65-inch OLED at 4 of 240 stores; the Switch 2 + Mario Kart World bundle at none.
Step 5: List the stores in a city
Stores with a city filters Media Expert's full store list, 1 credit; case and Polish accents do not matter:
curl -s https://api.scavio.dev/api/v1/mediaexpert/stores \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"city": "Warszawa"}'{
"data": {
"city": "Warszawa",
"total_stores": 637,
"count": 13,
"stores": [
{
"store_id": 911,
"store": "warszawa/lopuszanska-22",
"url": "https://www.mediaexpert.pl/sklepy/warszawa/lopuszanska-22",
"address": {"street": "Łopuszańska", "house_number": "22", "apartment": null, "postcode": "02-220", "city": "Warszawa"},
"latitude": 52.19219,
"longitude": 20.94935,
"hours": [{"day": "sunday", "open": "10:00", "close": "20:00"}, {"day": "monday", "open": "09:00", "close": "21:00"}],
"closed_today": false,
"next_open_day": "2026-11-23",
"services": ["Skrytka ME Box"]
}
]
},
"credits_used": 1
}Trimmed to 1 of 13 stores and 2 of 7 days. "Skrytka ME Box" is the store's parcel locker. Pass store with a reference such as warszawa/lopuszanska-22 for one store's page with its phone, events and alerts.
Step 6: Read reviews
Reviews by sku costs 1 credit for up to 100 reviews, and every review is reachable:
curl -s https://api.scavio.dev/api/v1/mediaexpert/reviews \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sku": "2095223", "limit": 100, "page": 1, "sort": "newest"}'{
"data": {
"sku": "2095223",
"sort": "newest",
"page": 1,
"limit": 100,
"total": 216,
"total_pages": 3,
"has_more": true,
"count": 100,
"average_rating": 4.87,
"recommendations": 212,
"verified_purchases": 195,
"reviews": [
{
"id": "01M77EEDQQTFJNVXMV6KNTJKXG",
"rating": 5,
"title": "Super",
"text": "Zgodny z opisem.",
"created_at": "2026-11-12 09:37:01",
"verified_purchase": true,
"incentivized": false,
"incentive_label": null,
"feature_ratings": [{"name": "Wydajność", "rating": 5}, {"name": "Aparat", "rating": 5}],
"helpful_yes": 0,
"helpful_no": 0,
"store_reply_count": 0
}
]
},
"credits_used": 1
}Trimmed to 1 of 100 reviews and 2 of 6 feature ratings. "Zgodny z opisem" means "as described".
ratingcan be a decimal, such as 4.8 or 4.7: 70 of the iPhone 17's 216 reviews were. Therating_minandrating_maxfilters take whole stars.verified_purchaseis Media Expert's "confirmed by purchase"; 195 of 216 here.incentivizedmarks a review written as part of a Media Expert promotional campaign ("Opinia z akcji promocyjnej"). For the Hisense WF5I1045BWQ washing machine, 280 of 554 reviews carried it, with an average rating of 4.97 against 4.76 for the rest.- No reviewer name or other identity is returned.
Step 7: Read the Black Weeks promotion lists
Promotions without a list returns the promotion lists Media Expert's promotions page links, 1 credit; black_weeks: true keeps the Black Weeks ones:
curl -s https://api.scavio.dev/api/v1/mediaexpert/promotions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"black_weeks": true}'{
"data": {
"query": null,
"black_weeks": true,
"total_lists": 20,
"count": 3,
"lists": [
{"list": "32975-logitech-black-weeks-czas-na-nowy-poziom-sprzetu", "list_id": 32975, "name": "Zyskaj rabat przy zakupie kierownicy w promocji", "url": "https://www.mediaexpert.pl/lista,32975-logitech-black-weeks-czas-na-nowy-poziom-sprzetu", "black_weeks": true}
]
},
"credits_used": 1
}Trimmed to 1 of 3 lists. Send list to read its products, with the same price fields as search:
curl -s https://api.scavio.dev/api/v1/mediaexpert/promotions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"list": "32975-logitech-black-weeks-czas-na-nowy-poziom-sprzetu", "limit": 50}'{
"data": {
"list": "32975-logitech-black-weeks-czas-na-nowy-poziom-sprzetu",
"list_id": 32975,
"kind": "products",
"title": "LOGITECH - BLACK WEEKS - Czas na nowy poziom sprzętu",
"page": 1,
"page_size": 50,
"total": 10,
"count": 10,
"items": [
{
"product_id": 870919,
"ean": "5099206057302",
"name": "Kierownica LOGITECH G29",
"price": 899,
"old_price": null,
"omnibus_lowest_30d": 899,
"code_price": {"price": 799.99, "code": "R1611-301126", "valid_from": "2026-11-16T00:00:00+01:00", "valid_to": "2026-11-30T23:59:00+01:00"},
"discount_percent": 11,
"discount_shown": {"amount": 99.01, "percent": 11},
"rating": 4.8,
"review_count": 185
}
]
},
"credits_used": 3
}Trimmed to 1 of 10 items. A list's products cost 3 credits here, because Media Expert loads the list lazily. Category facets carry a "Black Weeks" filter too: on November 21 it held 9 smartphones and 1 TV.
Step 8: Walk the category tree
Categories returns Media Expert's tree, or one branch, 2 credits. That is how to find a path such as the PS5 consoles:
curl -s https://api.scavio.dev/api/v1/mediaexpert/categories \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category": "gaming", "depth": 2}'{
"data": {
"category": {"category_id": 13306, "name": "Gaming", "path": "gaming", "url": "https://www.mediaexpert.pl/gaming", "product_count": 148052, "child_count": 38},
"depth": 2,
"count": 38,
"node_count": 248,
"categories": [
{
"category_id": 49972,
"name": "Playstation 5",
"path": "gaming/playstation-5",
"product_count": 17330,
"child_count": 12,
"children": [
{"category_id": 49976, "name": "Konsole PS5", "path": "gaming/playstation-5/konsole-ps5", "url": "https://www.mediaexpert.pl/gaming/playstation-5/konsole-ps5", "product_count": 19, "child_count": 0, "children": []}
]
}
]
},
"credits_used": 2
}Trimmed to 1 of 38 branches and 1 of 12 children. Brands and brand do the same for Media Expert's brand directory, outlet for its outlet, seller for a marketplace seller's offers, and suggestions for its search suggestions.
Step 9: Poll Black Week prices and count the credits
Black Friday is November 27, and most code prices we read were dated to end on November 30, December 1, December 6 or December 7. Scavio keeps no cache and no history, so a price history is the readings you store. This script reads every "Cena z kodem" product in four categories once, appends a row per product to a CSV, and sums credits_used:
import csv, datetime, json, os, urllib.request
KEY = os.environ["SCAVIO_API_KEY"]
BASE = "https://api.scavio.dev/api/v1/mediaexpert/"
CATEGORIES = [
"telewizory-i-rtv/telewizory",
"smartfony-i-zegarki/smartfony",
"komputery-i-tablety/laptopy-i-ultrabooki/laptopy",
"agd/pralki-i-suszarki/pralki",
]
def call(endpoint, body):
req = urllib.request.Request(BASE + endpoint, data=json.dumps(body).encode(), method="POST",
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
with urllib.request.urlopen(req, timeout=180) as r:
return json.load(r)
now = datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="seconds")
credits = 0
with open("mediaexpert-code-prices.csv", "a", newline="") as f:
out = csv.writer(f)
for path in CATEGORIES:
page = 1
while True:
res = call("category", {"category": path, "filters": ["promocje_cena-z-kodem"], "limit": 50, "page": page})
credits += res["credits_used"]
for it in res["data"]["items"]:
cp = it["code_price"] or {}
out.writerow([now, path, it["product_id"], it["ean"], it["price"], it["old_price"],
it["omnibus_lowest_30d"], cp.get("price"), cp.get("code"), cp.get("valid_to")])
if not res["data"]["has_more"]:
break
page += 1
print(f"{now}: {credits} credits")On November 21 that read was 13 pages, 13 credits, $0.013 at the Growth rate of $1 per 1,000 credits. Once a day from November 24 to December 1 is 8 reads, about 104 credits, depending on how many products the lists hold. Adding store stock for 10 products in one city each day is 20 credits more a day.
All 13 endpoints and their credits
| Endpoint | What it returns | Credits |
|---|---|---|
| search | Products for a query, 30 a page, with the price block | 3; 1 when Media Expert answers with a category page |
| category | One category's products with filters and sorts | 1 unsorted; 3 sorted or lazily loaded |
| product | One product in full | 1 |
| store-stock | Stock indicator and pickup within an hour at the 40 nearest stores | 2 |
| stores | The store list, a city's stores or one store | 1 |
| reviews | Up to 100 reviews a page | 1 |
| promotions | Promotion lists, or one list's products | 1 for the lists; 1 or 3 for a list's products |
| categories | The category tree or one branch | 2 |
| brands | The brand directory | 1 |
| brand | One brand's products | 1 unsorted; 3 sorted or lazily loaded |
| outlet | Outlet groups, or a group's products | 1; 3 sorted or lazily loaded |
| seller | A marketplace seller and its offers | 1; 3 sorted or lazily loaded |
| suggestions | Media Expert's search suggestions | 1 |
Every call reports credits_used. A request refused before the call and a failed upstream call are not charged; a not-found is.
What the API does not return: unit counts (the stock indicator is a bucket), price history beyond the 30-day low, Q&A (Media Expert has none), leaflets, basket or checkout prices, and any market other than Poland.
Getting started
- Sign up and copy your API key: 50 free credits, no card.
- Run a search or a product call in the playground.
- Pick the products you watch, save their
product_idandean, and poll the lists daily through Black Week. - Read store stock for the cities you care about, 2 credits per product and place.
- Match the same EAN on Allegro or Amazon with the same key.
Try the Media Expert API free, 50 credits, no card.
Reference: Media Expert API · store-stock docs · product docs · best Media Expert Black Week price APIs · is the PS5 Pro more expensive in Poland? · how to get Allegro price data · how to get Argos store stock and prices
Frequently asked questions
Does Media Expert have a public API?
No. Media Expert publishes no product, price or store-stock API. Approved marketplace sellers can create an API key in the Mirakl seller panel for their own offers and orders, and the affiliate programme gives tracking links. Scavio's Media Expert API returns Media Expert's public product, list, store-stock, store and review pages as JSON, 1 to 3 credits a call.
What does 'Najniższa cena z 30 dni przed obniżką' mean?
It means 'the lowest price in the 30 days before the reduction'. Media Expert prints it next to a promotion, as the EU Omnibus Directive requires, and the API returns it as omnibus_lowest_30d. Media Expert's own discount figure, returned as discount_shown, is measured from it.
Can I see Media Expert store stock by API?
Yes, as Media Expert shows it. The store-stock endpoint returns, for one product near a Polish city, town or postcode, the 40 nearest stores and pickup points with Media Expert's stock indicator (0, 2, 9 or 20 in our reads, not a unit count), whether it can be collected within an hour, and the day an order reaches that store when it is not on the shelf, for 2 credits.
Why does a store show 0 when the product is available online?
Because the product is not on that store's shelf, but you can still order it there. Media Expert then shows 'Do koszyka' (to basket) and the day the order reaches the store, such as 'w poniedziałek' (on Monday). On November 21, 2026 the Nintendo Switch 2 + Mario Kart World bundle was available online and on the shelf at none of 240 stores we checked.
What do Media Expert's terms say?
Scavio does not collect or store Media Expert data: each call fetches the public Media Expert page at the moment your request asks for it and returns what it shows as JSON, with no response cache. Media Expert's terms of service cover how its service may be used; read the current terms for your use case and get your own advice. This is not legal advice.