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

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

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": "..."}.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/mediamarkt/search?query=string"

{  "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  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}