Media Expert
Media Expert Store Stock API
One product's stock indicator at the Media Expert stores nearest a Polish city, town or postcode: up to 40 stores and pickup points, nearest first, each with Media Expert's stock indicator (a bucket such as 0, 2, 9 or 20, not a unit count), whether it can be collected within an hour, or the day an order reaches that store, plus distance, address, phone and opening hours. Marketplace items have no store stock, and a product Media Expert lists as not available returns the nearest stores with no stock data. Costs 2 credits.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonproduct_idstring | integerrequiredA Media Expert product id (items[].product_id, up to 8 digits). The offer id is refused. Marketplace items are not stocked in stores.
Example: 8128227
locationstringrequiredA Polish city or town (Warszawa, Kraków, Sanok) or a postcode (00-950): the stores nearest it are checked.
Example: Warszawa
limitintegerdefault:40Stores, nearest first, 1 to 40.
Example: 10
Notes
Store. One store: mediaexpert.pl, Poland, prices in PLN. There is no country input: Media Expert runs one Polish storefront. Names, specifications, labels, store names and review text come back in Polish, as Media Expert writes them; field names are English. Small towns list the nearest stores and pickup points, even when they are in other towns: Sanok on 2026-11-21 listed its pickup point and store, then stores up to 114 km away. Cost: 2 credits. Billing is the actual cost of the call, and every answer reports it in credits_used.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Where can I pick up an iPhone 17 within the hour near Warsaw? 2 credits.
data = client.mediaexpert.store_stock(product_id="8128227", location="Warszawa")["data"]
print(data["count"], "stores,", data["collect_in_1h_count"], "collect within an hour")
for s in data["stores"][:5]:
print(s["distance_km"], s["name"], s["stock_level"], s["collect_in_1h"], s["order_to_store_day"])Response