Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the MediaWorld API page →
docs / mediaworld

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.

base /mediaworld/v17 endpoints
post/mediaworld/v1/category2 credits

List one mediaworld.it category page, 12 products per page, with the same fields, sorts and filters as search.

ParameterAllowed / rangeDescription
categoryrequired—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 = 1optional1–30Result page, 1-based. 12 products per page; the storefront itself stops at page 30 (360 products), whatever `total_results` says.
sort = relevanceoptionalrelevance · price_asc · price_desc · rating · bestseller · newestResult order. Only orderings the storefront itself offers.
brandoptional—Keep only one brand, spelled as the site spells it (upper case: APPLE, SAMSUNG, SONY).
min_ratingoptional1–5Keep only products whose customer rating is at least this many stars (1-5).
max_rotations = 3optional1–5Advanced: how many times to retry a difficult request (1-5, default 3).
Try in playground →
post/mediaworld/v1/product2 credits

The 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.

ParameterAllowed / rangeDescription
product_idrequired—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 = 3optional1–5Advanced: how many times to retry a difficult request (1-5, default 3).
Try in playground →
post/mediaworld/v1/stores3 credits

MediaWorld'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).

ParameterAllowed / rangeDescription
cityoptional—Keep stores whose city or name contains this text (accent/case-insensitive).
provinceoptional—Keep stores in this province (two-letter sigla: MI, RM, TO, NA).
latitudeoptional-90–90Search point latitude (with longitude), instead of `near`.
longitudeoptional-180–180Search point longitude (with latitude).
radius_kmoptional1–1500With latitude/longitude: keep stores within this many km.
Try in playground →
post/mediaworld/v1/store1 credit

One MediaWorld store by id: name, address, coordinates, phone, e-mail, weekly opening hours, announced closures and holiday hours, SAP code and legal entity.

ParameterAllowed / rangeDescription
store_idrequired—MediaWorld store id (4 digits, e.g. 2473 = Roma Lega Lombarda, 2169 = Milano Piazza Lodi) from the `stores` or `nearby_availability` action.
Try in playground →
post/mediaworld/v1/store_availability1 credit

Store-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).

ParameterAllowed / rangeDescription
product_idsrequired—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_idrequired—MediaWorld store id (4 digits, e.g. 2473 = Roma Lega Lombarda, 2169 = Milano Piazza Lodi) from the `stores` or `nearby_availability` action.
Try in playground →
post/mediaworld/v1/nearby_availability1 credit

One 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.

ParameterAllowed / rangeDescription
product_idrequired—One MediaWorld product id (or a mediaworld.it product URL).
nearoptional—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.
latitudeoptional-90–90Search point latitude (with longitude), instead of `near`.
longitudeoptional-180–180Search point longitude (with latitude).
limit = 10optional1–49How many nearest stores to return, 1-49 (the source's ceiling: asking for 50 or 200 returns 49).
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.