Media Expert API: cena z półki, cena z kodem i stan magazynu z mediaexpert.pl

Media Expert nie udostępnia publicznego API do swojego katalogu. Dane pochodzą z mediaexpert.pl w takiej postaci, w jakiej widzi je klient bez logowania, a odpowiedź w JSON zawiera nazwę, markę, model, EAN, kategorię, ocenę, dostępność oraz każdą cenę, którą sklep pokazuje przy produkcie, w osobnym polu. Jest cena z półki (`price`), cena przekreślona, najniższa cena z 30 dni według dyrektywy Omnibus, cena z kodem razem z samym kodem i datami ważności, cena w aplikacji i cena klubowa. Kto zbiera ceny pralek albo telewizorów z Media Expert, widzi więc od razu, ile klient zapłaci z kodem, a nie tylko kwotę z etykiety. To nie jest integracja dla sprzedawców z marketplace Media Expert: API nie wystawia ofert i nie pobiera zamówień, czyta wyłącznie publiczną stronę sklepu.

Działający przykład

Fraza „pralka”, 28 października 2026. Media Expert przekierował ją na kategorię Pralki z 618 produktami, dlatego odpowiedź ma `search_mode: "category_redirect"`, a pod spodem poszły 3 zapytania do sklepu. Pralka Hisense z półki kosztuje 2999,99 zł, z kodem RW2210-301126 2799,99 zł; kod obowiązuje do 30 listopada, a ta sama kwota widnieje w aplikacji. Cenę z kodem miały 4 z 5 pralek, bez niej była tylko Candy za 959 zł. Filtry ceny i sortowanie korzystają z `filter_price`, czyli z ceny z kodem, gdy produkt ją ma.

curl -X POST https://api.reefapi.com/mediaexpert/v1/search \
  -H "x-api-key: TWOJ_KLUCZ" \
  -H "content-type: application/json" \
  -d '{"query": "pralka", "limit": 5}'

{
  "ok": true,
  "data": {
    "results": [
      {
        "product_id": 7975847,
        "erp_id": "2087062",
        "ean": "6901101832504",
        "model": "WF5I1045BWQ",
        "brand": "HISENSE",
        "title": "Pralka HISENSE Seria 5i WF5I1045BWQ 10.5kg 55cm 1400obr Sterowanie smartfonem",
        "currency": "PLN",
        "price": 2999.99,
        "price_net": 2439.02,
        "was_price": null,
        "omnibus_lowest_30d_price": 2999.0,
        "code_price": 2799.99,
        "promo_code": "RW2210-301126",
        "promo_valid_from": "2026-10-22T00:00:00+02:00",
        "promo_valid_to": "2026-11-30T21:59:00+01:00",
        "promo_discount": [ { "type": "amount", "value": 199.01 }, { "type": "percent", "value": 7 } ],
        "app_price": 2799.99,
        "member_price": null,
        "filter_price": 2799.99,
        "seller": { "type": "retailer", "name": "Media Expert", ... },
        "availability": {
          "status": "available",
          "label": "Dostępny",
          "description": "Dostępny od ręki",
          "available_in_store": true,
          "stock_online": 20,
          "stock_store": 20,
          "stock_capped": true
        },
        "rating": 4.9,
        "review_count": 509,
        "category": { "id": 13720, "name": "Pralki", "url": "https://www.mediaexpert.pl/agd/pralki-i-suszarki/pralki" },
        ...
      },
      ...
      {
        "product_id": 8181067,
        "brand": "CANDY",
        "title": "Pralka CANDY ProWash 100 EY 07SB7-S 7kg Slim 43.9cm 1000obr AI Silent Motion",
        "price": 959.0,
        "omnibus_lowest_30d_price": null,
        "code_price": null,
        "promo_code": null,
        "filter_price": 959.0,
        "rating": 4.8,
        "review_count": 92,
        ...
      },
      ...
    ],
    "total": 618,
    "total_reachable": 500,
    "page": 1,
    "limit": 5,
    "has_more": true,
    "search_mode": "category_redirect",
    "redirected_to": { "url": "https://www.mediaexpert.pl/agd/pralki-i-suszarki/pralki", "category_id": 13720 }
  },
  "meta": { "record_count": 5, "upstream_requests": 3, "charged_credits": 2, "cache_hit": false, "mode": "live" }
}

Ograniczenia i uczciwe uwagi

• Media Expert nie jest autorem tego API i go nie wspiera. Nie mamy ze sklepem ani umowy, ani współpracy.
• API czyta ceny ze sklepu internetowego mediaexpert.pl. Cen z etykiet w sklepach stacjonarnych nie zna; ze sklepów stacjonarnych podaje tylko dostępność i odbiór osobisty.
• Stan magazynowy jest ucięty na 20: `stock_online` i `stock_store` równe 20 oznaczają „co najmniej 20” (`stock_capped: true`). We wszystkich 5 pralkach z przykładu było 20.
• `price_min`, `price_max` i sortowanie po cenie działają na `filter_price`, czyli na cenie z kodem, jeśli produkt ją ma. Wiersz może mieć cenę z półki spoza zakresu i mimo to spełniać filtr.
• `limit` w `search` przyjmuje tylko 5, 10, 15, 20, 30 lub 50; inna wartość daje INVALID_PARAM. W `category` można podać do 50.
• Wyszukiwarka sklepu zwraca także akcesoria. Fraza „telewizor 55 cali” posortowana od najtańszych dała na pierwszych pięciu miejscach uchwyty ścienne za 18,45–34,85 zł (690 wyników). Do porównania cen samych telewizorów lepiej nadaje się `category`.
• Przy długich listach odpowiedź podaje `total_reachable`: dla „pralka” przy 5 produktach na stronę było to 500 z 618 (100 stron). Większy `limit` pozwala dojść dalej.
• Treści opinii, stanu w konkretnym sklepie i filtrów po marce czy parametrach technicznych API nie ma.
• Cena klubowa (`member_price`) pojawia się rzadko: przy budowie API miały ją 2 z 290 produktów, cenę z kodem 82, cenę Omnibus 95.
• Raty i opcje dostawy są w odpowiedzi tylko wtedy, gdy sklep je pokazuje. Dla pralki Hisense `product` zwrócił „Do 30 rat 0%” (30 × 93,33 zł), a `delivery_options` było null.
• Koszt w kredytach: `search` i `category` po 2, `product` 1, `description` 3. Nieudane wywołania są bezpłatne.