Piloterr

MediaMarkt Product

GET
/v2/mediamarkt/product

Read one MediaMarkt product by id or product URL, in the region you choose. You get price, currency, EAN, and availability.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Product URL or article id.

https://www.mediamarkt.ch/fr/product/_apple-iphone-15-2203371.html
region?string

Shop code when query is an article id. Example: ch-fr. Default ch-fr.

return_page_source?boolean

When true, return raw HTML as {"result": "..."}.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
id?string
ean?string
sku?string
url?string
name?string
brand?string
image?string
price?integer
locale?string
rating?number
region?string
currency?string
vat_rate?number
condition?string
price_note?string
availability?string
energy_class?string
review_count?integer
price_display?string
shipping_cost?integer
specifications?array<>
Example Request
curl -X GET 'https://api.piloterr.com/v2/mediamarkt/product?query=string'
Example Response
{  "id": "2203371",  "ean": "0195949036064",  "sku": "2203371",  "url": "https://www.mediamarkt.ch/fr/product/_apple-iphone-15-2203371.html",  "name": "APPLE iPhone 15 128 GB Black Dual SIM",  "brand": "APPLE",  "image": "https://assets.mmsrg.com/isr/166325/c1/-/ASSET_MMS_118271101",  "price": 629,  "locale": "fr-CH",  "rating": 4.69,  "region": "ch-fr",  "currency": "CHF",  "vat_rate": 0.08,  "condition": "new",  "price_note": "TVA incluse sans frais d'envoi",  "availability": "available",  "energy_class": "B",  "review_count": 391,  "price_display": "CHF 629.00",  "shipping_cost": 0,  "specifications": [    {      "name": "Type de produit",      "group": "Caractéristiques techniques",      "value": "Smartphone"    },    {      "name": "Système d'exploitation",      "group": "Caractéristiques techniques",      "value": "iOS"    }  ]}