mediamarkt.be APImediamarkt.be ↗
Search MediaMarkt Belgium's catalog, browse categories, and retrieve full product specs, pricing, ratings, and variants via 4 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/b861ff7d-c572-4037-a88c-2eb8324795bf/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on MediaMarkt.be by keyword using the internal GraphQL API. Returns paginated results with product names, prices, ratings, and images.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve. Each page contains up to 12 products. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'iphone 15 128gb') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"has_next": "boolean, whether more pages are available",
"products": "array of product objects with name, price, currency, rating, review_count, url, image, article_number, brand, and optional discount_percentage and old_price",
"total_on_page": "integer, number of products returned on this page",
"total_results": "integer, estimated total results across all pages"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"has_next": true,
"products": [
{
"url": "/nl/product/_lenovo-ideapad-slim-3-chrome-14m868-14-inch-full-hd-mediatek-kompanio-520-4-gb-128-gb-mali-g52-notebook-2175518.html",
"name": "LENOVO IdeaPad Slim 3 Chrome 14M868 - 14 inch - Full HD - MediaTek Kompanio 520 - 4 GB - 128 GB - Mali-G52",
"brand": "LENOVO",
"image": "https://assets.mmsrg.com/isr/166325/c1/-/ASSET_MMS_159105663",
"price": 299,
"rating": 4.6667,
"currency": "EUR",
"review_count": 3,
"article_number": "2175518"
}
],
"total_on_page": 12,
"total_results": 696
},
"status": "success"
}
}About the mediamarkt.be API
The MediaMarkt.be API gives developers structured access to Belgium's MediaMarkt catalog across 4 endpoints, covering product search, category browsing, and detailed product pages. The get_product_details endpoint returns up to a dozen fields per product including price, brand, color, storage variants, availability, and technical specifications. Results are paginated and include article numbers suitable for inventory tracking or price monitoring.
Search and Browse
The search_products endpoint accepts a query string (e.g. 'laptop' or 'iphone 15 128gb') and an optional page integer. Each page returns up to 12 products with name, price, currency, rating, review_count, url, image, article_number, brand, and an optional discount field. The total_results field gives an estimated count across all pages, and has_next signals whether additional pages exist.
The get_category_products endpoint works similarly but scopes results to a specific category using a category_slug parameter that matches the URL path — for example 'laptop-866' or 'telefonie-wearables-891'. The get_main_categories endpoint (no inputs required) returns the full list of top-level navigation categories with their name, slug, and url, making it straightforward to discover valid slugs before querying category listings.
Product Detail
The get_product_details endpoint accepts either a full product URL or a slug such as 'apple-iphone-15-5g-128-gb-blue-mtp43zda-2107453'. It returns name, brand, color, storage, price, rating, description, availability, and a variants object containing colors and storage arrays — each with a variant name and url. This makes it possible to enumerate all purchasable configurations of a product without additional lookups.
Coverage and Pagination
All listing endpoints (search_products, get_category_products) expose page, total_on_page, and has_next fields for cursor-style pagination. The currency field is fixed to EUR, reflecting MediaMarkt Belgium's pricing. Article numbers (article_number) are consistent across search and category results, enabling deduplication when the same product appears in multiple queries.
- Track price changes on specific products by polling
get_product_detailswith a stored product slug - Build a category navigator by fetching
get_main_categoriesthen paginating throughget_category_productsfor each slug - Enumerate all color and storage variants for a product line using the
variantsobject fromget_product_details - Monitor in-stock availability across a product set using the
availabilityfield returned byget_product_details - Aggregate brand-level pricing data by filtering
search_productsresults by thebrandresponse field - Compile product ratings and review counts across a category by paginating
get_category_productsand readingratingandreview_count
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MediaMarkt have an official public developer API?+
What does the `get_product_details` endpoint return beyond basic pricing?+
price, it returns brand, color, storage, description, availability, rating, a main image URL, and a variants object listing all color and storage configurations with their individual URLs. The brand and color fields can be null when the source data does not include them.Does the search endpoint support filtering by brand, price range, or other facets?+
search_products endpoint currently accepts only a query string and a page number. Facet filtering by brand, price range, or category is not exposed. You can fork this API on Parse and revise it to add a filtering endpoint if that capability is needed.How many products does each page return, and is there a way to get more per page?+
search_products returns up to 12 products, matching MediaMarkt.be's default pagination. There is no parameter to increase the page size. The total_results field gives an estimated total so you can calculate how many pages to iterate.Are promotions, bundle deals, or historical price data available through this API?+
discount field on search results when a markdown is present, but historical pricing, bundle configurations, and promotional campaign details are not covered. You can fork this API on Parse and revise it to add an endpoint targeting promotional or deals pages.