Media Expert API

Search Poland's largest electronics retailer, then read every price a product has: shelf, promo code, app and Omnibus

Media Expert is Poland's largest electronics and home-appliance retailer (TVs, phones, laptops, washing machines, coffee machines), selling its own stock and, for some products, through marketplace sellers.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Media Expert endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
M
/mediaexpert/v1

4 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/mediaexpert/v1/search
  • POST/mediaexpert/v1/category
  • POST/mediaexpert/v1/product
  • POST/mediaexpert/v1/description

What Media Expert endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

4 endpoints

search

2 cr

Search mediaexpert.pl by keyword with the site's own price range (PLN), discounted-only switc…

required
query
optional
price_min, price_max, only_discounted, sort, page, limit

category

2 cr

List one Media Expert category (e.g.

required
—
optional
category_id, url, price_min, price_max, only_discounted, sort, page, limit

product

1 cr

The full Media Expert product record by product id, URL or erp id.

required
—
optional
product_id, url, erp_id

description

3 cr

The long product description Media Expert shows under 'Opis', as plain text (HTML and the emb…

required
—
optional
product_id, url, erp_id

Every parameter, every allowed value →

Media Expert API

4 of 4 endpoints, ready to run

View docs ↗

iPhone 17 on Media Expert

2 credits1 required · 1 optional
POST/mediaexpert/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Media Expert API works

Media Expert is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 549 engines.

02
Call
POST /mediaexpert/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a keyword to a daily Media Expert price feed

Search once to find the products and their categories, list a whole category with filters, then follow each product with product.

01search?query=iphone
GET/mediaexpert/v1/search?query=iphone
17

30 products per page with shelf, promo-code, app and Omnibus prices, stock, seller and category.

02category?category_id=<category.id>&only_discounted=true&sort=price_asc
GET/mediaexpert/v1/category?category_id=<category.id>&only_discounted=true&sort=price_asc

One category, on promotion only, cheapest first; page with page=2, 3 … while has_more is true.

03product?product_id=<product_id>
GET/mediaexpert/v1/product?product_id=<product_id>

Every price type with the code and its dates, EAN, model, stock, store availability, specifications and images.

04description?product_id=<product_id>
GET/mediaexpert/v1/description?product_id=<product_id>

The long product description as plain text, when you need it.

A dated Media Expert price feed per product with the shelf price, the promo-code price and its end date, and the Omnibus 30-day price kept apart.

request
curl -X POST https://api.reefapi.com/mediaexpert/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 17","limit":10}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "mediaexpert",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What a Media Expert field actually contains

Fields that read differently from how they look. Every row was measured against live Media Expert responses on 2026-10-15.

FieldWhat it holds
product_id, erp_id, offer_idproduct_id (e.g. 7872945) is what product and description take; a product URL or the erp_id works too. erp_id is Media Expert's item number, the same value as the productID/sku in the product page's structured data. offer_id is the offer behind the product and is not accepted as a product id.
priceThe shelf price in PLN, VAT included. It equalled the price in the product page's own structured data on every product checked.
code_price, promo_code, promo_valid_from, promo_valid_to, promo_activeThe lower price Media Expert gives with a promo code at checkout, the code itself and the dates it runs. promo_active says whether today is inside those dates; Media Expert can still publish a code whose dates have passed.
app_price, app_promo_codeA price that only applies in the Media Expert mobile app, with its own code. Kept apart from the web prices.
omnibus_lowest_30d_priceThe lowest price of the last 30 days that EU Omnibus rules require next to a promotion. Published only when Media Expert prints it.
was_price, member_pricewas_price is the crossed-out price; member_price the club price. Both are often empty because Media Expert shows them on few products.
filter_priceThe price the price_min / price_max range is compared against: the promo-code price while a code is active, otherwise the shelf price. A product shelf-priced above the range can therefore appear in it.
availability.stock_online, stock_store, stock_cappedUnits Media Expert reports for delivery and for its stores. The source never reports more than 20, so 20 means 20 or more and stock_capped is true.
seller.typeretailer when Media Expert sells the product itself, marketplace when a third-party shop does, with the shop's name, link, rating count and minimum shipping cost.

Prices from search equalled prices from product on 12 of 12 products. The product price, EAN and item number equalled the product page's own structured data on 8 of 8 products checked, 3 of them with an active promo code (the page's structured data carries the shelf price, not the code price). The same 4 products read from two different networks returned identical prices.

Media Expert coverage, measured

Every number below was read from live Media Expert responses on 2026-10-15.

Catalogue

mediaexpert.pl (Poland, PLN). Washing machines 616 products, headphones 2,883; 'laptop lenovo' 869, 'odkurzacz dyson' 96; search reports up to 5,000 matches.

Filters that bite

Washing machines 616 → 1,000-2,000 zł 280, on promotion 208; 'iphone 17' 3,000-5,000 zł 18. Price and rating sorts reorder the list; an id that is not a category is refused.

Price accuracy

Product price, EAN and item number equalled the product page's own structured data on 8 of 8 products (3 with an active promo code); search and product agreed on 12 of 12.

Fields

On 290 products from 8 searches and 4 category listings: id, title, brand, URL, image, price, seller, availability and stock 290 of 290; EAN 288; rating 234; promo-code price 82; app price 83; Omnibus 30-day price 95; crossed-out price 12; club price 2.

Limits

Stock counts stop at 20; no per-store stock; written reviews not returned; search pages hold 5, 10, 15, 20, 30 or 50 products, category pages up to 50.

What people build with Media Expert

The jobs this data is most often used for.

4

endpoints

1/2/3

credits per call

01

Track Media Expert shelf prices, promo-code prices and Omnibus 30-day prices on electronics and appliances day by day.

02

Match Media Expert products to other Polish retailers by EAN or model.

03

Watch which promo codes run on which products and when they end.

04

Find the cheapest products on promotion within a price range in one category.

What Media Expert data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 549 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/mediaexpert/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 17","limit":10}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/mediaexpert/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "iphone 17",
  "limit": 10
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Media Expert.

Get a free key →
Do I need a Media Expert account?▾

No. Everything is read logged out, and you call reefapi.com from anywhere.

Which price is the real one?▾

All of them are real, they apply to different shoppers: price is the shelf price, code_price applies with the promo code shown next to it, app_price only in Media Expert's app, member_price for club members. omnibus_lowest_30d_price is the reference price the law requires during a promotion.

Do the filters work?▾

Yes, each was checked against the unfiltered count in the same run. Washing machines: 616 products, 1,000-2,000 zł 280, on promotion 208. Search 'iphone 17' between 3,000 and 5,000 zł returned 18 products. The price range is compared with the promo-code price when a code is active.

Why does my search return a category?▾

Media Expert sends some keywords straight to a category page (for example 'pralka' to washing machines). The API then lists that category and tells you in redirected_to and search_mode, rather than returning nothing.

How deep can I page?▾

Up to 100 pages. Search reports at most 5,000 matches; total_reachable tells you how many you can actually page through, and a page past the end returns no rows with page_clamped set.

Is stock by store included?▾

The record says whether the product is available in Media Expert stores and how many units the stores and the web shop report (capped at 20 by the source). Stock per individual store is not returned.

Are reviews included?▾

The average rating and the review count are on every product. The written reviews are not returned at present.

What is the Media Expert API?▾

Media Expert API is a ReefAPI endpoint group for poland's largest electronics and appliance retailer: pln shelf, promo-code, app and omnibus 30-day prices, stock, store pickup, ean and specs. It returns live JSON through POST requests under /mediaexpert/v1.

Is the Media Expert API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Media Expert calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Media Expert login or account?▾

No login to Media Expert is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Media Expert data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Media Expert API use?▾

Media Expert actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Media Expert from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call mediaexpert actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Media Expert API a Media Expert scraper?▾

It is the managed alternative to a DIY Media Expert scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same poland's largest electronics and appliance retailer: pln shelf, promo-code, app and omnibus 30-day prices, stock, store pickup, ean and specs back as clean JSON.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 548 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-15.