Piloterr

MediaMarkt Search

GET
/v2/mediamarkt/search

Search a MediaMarkt shop by keyword. Set region for Switzerland, Germany, Austria, and the other MediaMarktSaturn countries, then page the results.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
headerx-api-key<token>

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

Parâmetros de consulta

query*string

Keyword or MediaMarkt URL. Example: iphone

region?string

Shop code. Example: ch-fr or de. Default ch-fr. Ignored when query is a full URL.

page?number

Page number from 1. Example: 1

Range1 <= value
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

Corpo da resposta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/mediamarkt/search?query=string'
Example Response
{  "results": [    {      "id": "2203371",      "ean": "0195949036064",      "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",      "availability": "available",      "energy_class": "B",      "review_count": 391,      "price_display": "CHF 629.00",      "shipping_cost": 0,      "is_marketplace": false    }  ],  "pagination": {    "next": "https://www.mediamarkt.ch/fr/category/apple-iphones-789083.html?page=2",    "page": 1,    "per_page": 12,    "total_pages": 43,    "total_results": 511  }}