MediaWorld
MediaWorld Italy (mediaworld.it, MediaMarkt's Italian chain): product search by keyword or EAN with prices, discounts and ratings, full product records, the 158 stores with hours and coordinates, and store-level pickup availability per product.
/mediaworld/v1/search2 creditsSearch mediaworld.it by keyword or EAN, 12 products per page (the site stops at page 30), with the price a shopper pays now online and for click & collect (one national price), the struck-through price and its type (RRP = manufacturer list price), discount, app-only and club (member) price only when they differ, financing, seller (MediaWorld or a marketplace seller), online / delivery / pickup status with the delivery window, rating on a 5-star scale with review count, EAN, category path, energy class and key features. Sort by price, rating, bestseller or newest; filter by brand and minimum rating.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words as a shopper types them on mediaworld.it. An EAN/GTIN (e.g. 195950543742) finds the product it belongs to. |
| page = 1 | optional | 1–30 | Result page, 1-based. 12 products per page; the storefront itself stops at page 30 (360 products), whatever `total_results` says. |
| sort = relevance | optional | relevance · price_asc · price_desc · rating · bestseller · newest | Result order. Only orderings the storefront itself offers. |
| brand | optional | — | Keep only one brand, spelled as the site spells it (upper case: APPLE, SAMSUNG, SONY). |
| min_rating | optional | 1–5 | Keep only products whose customer rating is at least this many stars (1-5). |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5, default 3). |
/mediaworld/v1/category2 creditsList one mediaworld.it category page, 12 products per page, with the same fields, sorts and filters as search.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | A mediaworld.it category page URL (…/it/category/<name>-<id>.html) or its path. Category URLs appear in the site navigation and in every product's breadcrumb. |
| page = 1 | optional | 1–30 | Result page, 1-based. 12 products per page; the storefront itself stops at page 30 (360 products), whatever `total_results` says. |
| sort = relevance | optional | relevance · price_asc · price_desc · rating · bestseller · newest | Result order. Only orderings the storefront itself offers. |
| brand | optional | — | Keep only one brand, spelled as the site spells it (upper case: APPLE, SAMSUNG, SONY). |
| min_rating | optional | 1–5 | Keep only products whose customer rating is at least this many stars (1-5). |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5, default 3). |
/mediaworld/v1/product2 creditsThe full mediaworld.it product record: title, brand, EAN, manufacturer part number (the spec row 'Numero articolo del produttore'), national price with the struck-through price and its type, discount, app-only / club price when they differ, financing, seller, online / delivery / pickup status (pickup without a chosen store: use store_availability), delivery window and shipping cost, images, the complete grouped specification, description, colour / size variants with their own price and status, other marketplace offers, rating distribution and the first page of reviews.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | MediaWorld product id — the number at the end of a mediaworld.it product URL (…/product/_apple-airpods-pro-3-187780.html → 187780). A full mediaworld.it product URL is also accepted. Every `search` row returns `product_id`. |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5, default 3). |
/mediaworld/v1/stores3 creditsMediaWorld's whole store network in Italy (158 stores, one request): store id, name, street, postcode, city, province, coordinates, phone, e-mail, weekly opening hours, announced closures and holiday hours, SAP code and the store's legal entity. Narrow by city / province text, or pass latitude/longitude to sort by distance (computed from the published coordinates).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | optional | — | Keep stores whose city or name contains this text (accent/case-insensitive). |
| province | optional | — | Keep stores in this province (two-letter sigla: MI, RM, TO, NA). |
| latitude | optional | -90–90 | Search point latitude (with longitude), instead of `near`. |
| longitude | optional | -180–180 | Search point longitude (with latitude). |
| radius_km | optional | 1–1500 | With latitude/longitude: keep stores within this many km. |
/mediaworld/v1/store1 creditOne MediaWorld store by id: name, address, coordinates, phone, e-mail, weekly opening hours, announced closures and holiday hours, SAP code and legal entity.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| store_id | required | — | MediaWorld store id (4 digits, e.g. 2473 = Roma Lega Lombarda, 2169 = Milano Piazza Lodi) from the `stores` or `nearby_availability` action. |
/mediaworld/v1/store_availability1 creditStore-level availability of 1-32 products at one MediaWorld store, in one request: whether each product is in that store now ('Ritiro in 30 minuti') or can be collected from a date (the collection window), not collectable, not released yet, or a marketplace item, with the time until which the source says the window holds. MediaWorld publishes statuses and dates, not stock counts, and one national price (no store-specific price).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_ids | required | — | 1 to 32 MediaWorld product ids (the number at the end of a product URL; every search row returns `product_id`). The source answers all of them for the store in ONE request; 33 or more is refused by the source. |
| store_id | required | — | MediaWorld store id (4 digits, e.g. 2473 = Roma Lega Lombarda, 2169 = Milano Piazza Lodi) from the `stores` or `nearby_availability` action. |
/mediaworld/v1/nearby_availability1 creditOne product at the nearest MediaWorld stores of a city, postcode or point (1-49 stores, one request, nearest first): each store's address, coordinates, distance, opening hours, whether the store takes pickups, and the product's pickup status there — in store now vs the collection date window. The place is resolved by MediaWorld's own store search.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | One MediaWorld product id (or a mediaworld.it product URL). |
| near | optional | — | An Italian city name or postcode (CAP), resolved by MediaWorld's own store search (`found_location` in the answer). One of `near` or latitude/longitude is required. |
| latitude | optional | -90–90 | Search point latitude (with longitude), instead of `near`. |
| longitude | optional | -180–180 | Search point longitude (with latitude). |
| limit = 10 | optional | 1–49 | How many nearest stores to return, 1-49 (the source's ceiling: asking for 50 or 200 returns 49). |
curl -X POST https://api.reefapi.com/mediaworld/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"airpods pro 3"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.