Reef AI: ask for any data. Try it
MediaWorld API

MediaWorld Italy prices and store-level availability, product by product

MediaWorld is MediaMarkt's electronics chain in Italy, at mediaworld.it, with 158 stores.

endpoints
7
credits per call
1–3

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

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

  • POST/mediaworld/v1/search2 credits
  • POST/mediaworld/v1/category2 credits
  • POST/mediaworld/v1/product2 credits
  • POST/mediaworld/v1/stores3 credits
  • POST/mediaworld/v1/store1 credit
  • POST/mediaworld/v1/store_availability1 credit
  • POST/mediaworld/v1/nearby_availability1 credit
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

MediaWorld API

4 of 7 endpoints, ready to run

View docs ↗

AirPods Pro 3 at MediaWorld

2 credits1 required · 0 optional
POST/mediaworld/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.

Try every endpoint in the playground

Endpoints

What MediaWorld endpoints does ReefAPI ship?

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

7 endpoints

search

2 cr

Search mediaworld.it by keyword or EAN, 12 products per page (the site stops at page 30), wit…

required
query
optional
page, sort, brand, min_rating, max_rotations

category

2 cr

List one mediaworld.it category page, 12 products per page, with the same fields, sorts and f…

required
category
optional
page, sort, brand, min_rating, max_rotations

product

2 cr

The full mediaworld.it product record.

required
product_id
optional
max_rotations

stores

3 cr

MediaWorld's whole store network in Italy (158 stores, one request).

required
—
optional
—

store

1 cr

One MediaWorld store by id.

required
store_id
optional
—

store_availability

1 cr

Store-level availability of 1-32 products at one MediaWorld store, in one request.

required
product_ids, store_id
optional
—

nearby_availability

1 cr

One product at the nearest MediaWorld stores of a city, postcode or point (1-49 stores, one r…

required
product_id
optional
—

Every parameter, every allowed value →

Missing a MediaWorld endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the MediaWorld API works

MediaWorld 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 752 engines.

02
Call
POST /mediaworld/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 nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

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

Recipe

Is it in a store near me today?

Find the product by EAN, then ask the nearest stores.

01search?query=195950543742
GET/mediaworld/v1/search?query=195950543742

One row: APPLE AirPods Pro 3, product_id 187780, with price and EAN.

02nearby_availability?product_id=187780&near=Milano&limit=10
GET/mediaworld/v1/nearby_availability?product_id=187780&near=Milano&limit=10

The 10 nearest Milano stores, nearest first, each in store now or collectable from a date.

03store_availability?product_ids=187780&store_id=2169
GET/mediaworld/v1/store_availability?product_ids=187780&store_id=2169

One store, up to 32 products in the same call, with the collection window.

04store?store_id=2169
GET/mediaworld/v1/store?store_id=2169

That store's address, phone and opening hours.

Store-by-store availability of the same product across MediaWorld Italy, with collection dates.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "mediaworld",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a MediaWorld field actually contains

Fields that read differently from how they look. Every row was measured against live answers on 2026-11-22.

FieldWhat it holds
priceWhat a shopper pays now on mediaworld.it, the same for delivery and for click & collect. It matched the price on the product's own page for 6 of 6 products in 5 categories.
was_price, was_price_typeThe struck-through price and what kind of price it is (RRP = the manufacturer's list price). null when the site shows no struck price, even if a list price exists behind it.
app_price, member_priceThe app-only price and the club member price, filled only when they differ from price (member price on 11 of 60 search rows).
ean, manufacturer_part_numberThe EAN matched the product page for 6 of 6 products. manufacturer_part_number is the spec row "Numero articolo del produttore" (MFHP4ZM/A for the AirPods Pro 3), filled for 6 of 6 products.
pickup_status, pickup_kind, in_store_nowPer product and store: in_store_now is true only when the site says "anche in 30 minuti" (stock in that store now). Otherwise pickup_kind says tomorrow, on_date (collection from the date in pickup_earliest), after_release or not_available.
pickup_earliest, pickup_latest, promise_valid_untilThe collection window in UTC, and the time until which the site says that window holds. They are the only freshness signal MediaWorld publishes.
site_labelThe site's own Italian sentence for that status, with the date in Italian local time.
distance_kmKilometres from the place you searched to the store, worked out from the store's published coordinates; MediaWorld itself returns no distance.
known_productfalse when MediaWorld does not know the product id at all (then a one-product call answers NOT_FOUND).

MediaWorld does not publish stock counts, store-specific prices, start or end dates of a product's price promotion, or a delivery promise per store. Search stops at page 30 (360 products) whatever total_results says.

Coverage

MediaWorld coverage, measured

Every number below was read from live answers on 2026-11-22: 65 calls over the catalogue, the store list and store-level availability, and 6 products compared with their own product pages.

Stores

158 MediaWorld stores, all with coordinates, e-mail and weekly opening hours; phone on 156 of 158.

Price accuracy

Price and EAN equal to the product page for 6 of 6 products in 5 categories (headphones, washing machines, smartphones, OLED TVs, wireless headphones).

Store availability

Up to 32 products per store in one call; 1 to 49 nearest stores per product. Milano, AirPods Pro 3: 10 nearest stores, 5 with the product in store now.

Search

12 products per page up to page 30; "cuffie" 22,941 results, brand APPLE 1,218, rating 4+ 4,207; an EAN returns its product.

Speed

28 of 28 calls answered; median about 1 s for store calls, 1.9 s for search, 2.6 s for a product record.

Not published

Stock counts, store-specific prices, product price promotion dates, delivery promise per store.

Use cases

What people build with MediaWorld

The jobs this data is most often used for.

7

endpoints

1/2/3

credits per call

01

Check which MediaWorld stores in Milano or Roma have a product in stock now and which can only collect it later.

02

Compare the same product (by EAN) between MediaWorld and other Italian electronics chains.

03

Track MediaWorld prices, struck prices and discounts on a list of products every day.

04

Map all 158 MediaWorld stores with opening hours and holiday closures.

Pricing

What MediaWorld 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 752 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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/mediaworld/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"airpods pro 3"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/mediaworld/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "airpods pro 3"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up MediaWorld.

Is this the same as MediaMarkt?▾

MediaWorld is MediaMarkt's Italian chain and runs on the same platform. This API is mediaworld.it only: prices in EUR, Italian product names, Italian stores. The other MediaMarkt countries have their own API.

Can I search by EAN?▾

Yes. search accepts an EAN: 195950543742 returned exactly one product, the APPLE AirPods Pro 3 (187780). Every row and product record also carries its EAN.

Can I see whether a product is in a specific store?▾

Yes. store_availability takes up to 32 product ids and one store id and answers all of them in one call: in the store now ("anche in 30 minuti"), collectable tomorrow, collectable from a date with the date, not released yet, or not collectable there. On 2026-11-22 the AirPods Pro 3 were in store now at Milano Piazza Lodi and collectable from 26/11/2026 at Roma Lega Lombarda.

How do I find the nearest stores that have a product?▾

nearby_availability takes one product id and a city, postcode (CAP) or latitude/longitude and returns the 1 to 49 nearest MediaWorld stores, nearest first, each with the product's pickup status. "Milano" with limit 10 returned 10 stores from 2.16 km, 5 of them with the AirPods Pro 3 in store now.

Does MediaWorld have different prices per store?▾

MediaWorld publishes one national price per product, the same online and for click & collect; app-only and club prices are shown separately. It does not publish a store-specific price.

Does it show stock quantities?▾

No. MediaWorld shows statuses and dates, not counts. in_store_now and the collection window are what the site itself shows a shopper.

What store data is included?▾

All 158 stores: id, name, street, postcode, city, province, coordinates, phone, e-mail, weekly opening hours (split days as two rows), announced closures and holiday hours, and the store's legal entity.

How fast is it?▾

In a 28-call test on 2026-11-22 every call answered: store calls took a median of about 1 s, nearby_availability 1.4 s, search 1.9 s and product 2.6 s.

What is the MediaWorld API?▾

MediaWorld API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /mediaworld/v1.

Is the MediaWorld API free to try?▾

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

Do I need a MediaWorld login or account?▾

No login to MediaWorld 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 MediaWorld 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 MediaWorld API use?▾

MediaWorld 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 MediaWorld from an AI assistant or MCP client?▾

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

Contact

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 751 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-11-22.