By the end of this tutorial, you will have a short Python script that turns a MediaMarkt search into rows: name, price, strike price, discount, seller, rating, delivery line and URL.
MediaMarkt sells consumer electronics through national web shops; this Actor covers nine of them (Germany, Spain, Austria, the Netherlands, Belgium, Switzerland, Poland, Turkey, and MediaWorld in Italy).
In this guide, we use Python and the Apify Actor MediaMarkt & MediaWorld Scraper (reventadata/mediamarkt-scraper). You will configure a search, run the Actor and filter the rows. The sample row below is a sample from a capture dated 2026-10-24 (mediamarkt.de, search laptop, page 1), parsed with the Actor's own parser.
⏱️ Time estimate: one sitting: install one package, set one token, run three short Python blocks.
Prerequisites
To follow this tutorial, you will need:
- Python 3.11+ (
apify-client3.3.0 requires it). - The Apify API client for Python, version 3.
- An Apify account and its API token, which sits on the API & Integrations page in Apify Console.
Install or upgrade the client:
pip install -U "apify-client~=3.0" The code reads the token from an environment variable:
export APIFY_API_TOKEN="your_apify_token_here" What you'll achieve
You will turn a MediaMarkt search into one row per product card. Each row carries the article id and url, name, brand, price, originalPrice (the struck-through price), discountPercentage, currency, seller, condition, rating, reviewsCount, availability (the delivery line), image, country and matchedKeyword.
Note: for a marketplace partner's offer,
sellerreadsMarketplace Seller; the partner's shop name is not stored in the row.
Example use case: Suppose you want new laptops on mediamarkt.de priced between 400 and 800 euros. You would set searchQueries: ["laptop"], country: "DE", condition: "NEW", minPrice: 400 and maxPrice: 800, and every saved row would carry a price inside that band.
Step 1: Access MediaMarkt & MediaWorld Scraper
Go to the MediaMarkt & MediaWorld Scraper page on Apify Store. The README lists every input and output field. In this tutorial we drive the Actor from Python, so everything after this step happens in code.
Step 2: Configure the search
The main input is searchQueries: one MediaMarkt search per term, written the way you would type it in the shop's search box (laptop, iphone 15, kaffeemaschine). Two more inputs set where and in what order:
-
country: one ofDE,ES,IT,AT,NL,BE,CH,PL,TR(defaultDE). Prices come in the storefront's currency: EUR, CHF for Switzerland, PLN for Poland, TRY for Turkey. -
sort:DEFAULT(relevance),PRICE_ASC,PRICE_DESC,RATING,BEST_SELLERS,NEWESTorAVAILABILITY.
maxPages (1 to 50, default 5) bounds how many result pages each query reads, and maxItems (1 to 5000, default 60) caps the rows saved across all queries. The captured page held 12 product cards.
Here is the setup. It searches laptop on mediamarkt.de, reads one result page and saves at most 20 rows:
import os from apify_client import ApifyClient # 1. Initialize ApifyClient with the token from the environment client = ApifyClient(os.environ["APIFY_API_TOKEN"]) # 2. Define the search: one keyword, one storefront, one result page run_input = { "searchQueries": ["laptop"], "country": "DE", "maxPages": 1, "maxItems": 20, } 💡 Tip: search in the storefront's language. Product titles on mediamarkt.de are German, and the Actor matches your term against each title (Step 4).
No proxy setting is needed in run_input: proxy is handled for you.
Step 3: Add optional filters
These filters run on the rows after each page is read. Rows a filter drops never reach your dataset:
| Parameter | Type | What it keeps |
|---|---|---|
minPrice / maxPrice | number | Rows whose price is inside the band, in the storefront's currency. Rows without a price are dropped when either is set. |
condition | ALL / NEW / REFURBISHED | Rows by condition, read from the product title (generalüberholt, reacondicionado, ricondizionato, refurbished, odnowiony, yenilenmiş). |
brand | string | Rows whose brand or title contains it, ignoring case and accents. |
includeKeywords / excludeKeywords | array | Words the title or brand must all contain / must not contain. |
Three combinations that work:
- Cheapest first:
sort: "PRICE_ASC",searchQueries: ["notebook"]. - One brand, refurbished:
brand: "Apple",condition: "REFURBISHED". - A spec, minus the noise:
includeKeywords: ["16 GB"],excludeKeywords: ["Chromebook"].
⚠️
country,sortandconditiontake only the listed values; anything else is refused before the run starts.
Step 4: Run the Actor
Now start the run with client.actor("reventadata/mediamarkt-scraper").call(run_input=run_input). The call starts the Actor on Apify and waits for it to finish before returning the run:
# 3. Start the Actor run and wait for it to finish print("Starting MediaMarkt extraction...") run = client.actor("reventadata/mediamarkt-scraper").call(run_input=run_input) if run is None or run.status != "SUCCEEDED": status = run.status if run else "unknown" raise SystemExit(f"Run did not succeed (status: {status}).") # 4. Fetch the saved products items = client.dataset(run.default_dataset_id).list_items().items print(f"Retrieved {len(items)} products.\n") Behind the scenes:
- The Actor walks each result page for your search.
- It parses each product card and keeps a card only if its title contains your search term or a synonym: for
laptopthose arenotebook,book,portatil,portatile,chromebookandchrome. On the captured page, 3 of the 12 titles (a MEDION, an HP OMEN and an Acer Aspire) contain none of them, so alaptopsearch would not save those three. - It applies your filters and saves the rows, stopping at
maxItems, atmaxPages, or when a page comes back empty.
Step 5: View and download results
Loop over the rows to print the parts you need:
for item in items: print(item["name"]) print(f" Price: {item.get('price')} {item.get('currency')}") if item.get("originalPrice") is not None: print(f" Strike price: {item['originalPrice']} (-{item.get('discountPercentage')}%)") print(f" Seller: {item.get('seller')}") print(f" Rating: {item.get('rating')} ({item.get('reviewsCount')} reviews)") print(f" Delivery: {item.get('availability')}") print("-" * 40) Here is one row, a sample from a capture dated 2026-10-24 (mediamarkt.de, search laptop, page 1) parsed with the Actor's own parser. A saved row also carries scrapedAt, added at save time:
{ "id": "3037446", "name": "SAMSUNG Galaxy Book4 Edge, Copilot+ PC - 15,6 Zoll - Qualcomm Snapdragon X X1 26 100 - 16 GB - 256 GB - Qualcomm Adreno™ Onboard Graphics - Windows 11 Home", "brand": "Samsung", "price": 599.0, "originalPrice": 1019.0, "discountPercentage": 41.0, "currency": "EUR", "seller": "MediaMarkt Germany", "condition": "new", "url": "https://www.mediamarkt.de/de/product/_samsung-galaxy-book4-edge-copilot-pc-156-zoll-qualcomm-snapdragon-x-x1-26-100-16-gb-256-gb-qualcomm-adrenotm-onboard-graphics-windows-11-home-3037446.html", "image": "https://assets.mmsrg.com/isr/166325/c1/-/ASSET_MMS_177838409?x=416&y=416&format=webp&quality=60&sp=yes&strip=yes&trim=yes&ex=416&ey=416&align=center&resizesource&unsharp=0.5x0.5", "rating": 4.9, "reviewsCount": 30, "availability": "Lieferung nach Hause 27.10.2026 - 28.10.2026", "country": "DE", "matchedKeyword": "laptop" } Apify datasets export as JSON, CSV, XML, Excel, HTML table, RSS or JSONL.
Understanding your results
The fields that matter most:
-
priceandcurrency: the price shown on the card, parsed from formats such as599,– €. Instalment offers printed in the same price box (18 Raten à 36,08 €) are not read as the price. -
originalPrice: the struck-through price, which is not always the same kind of price. On the captured page, all 6 cards sold by MediaMarkt showed a manufacturer's list price (UVP), and all 6 marketplace cards showed the lowest price of the last 30 days (Tiefstpreis (30 Tage)). The row does not say which;sellertells the two groups apart on that page. -
discountPercentage: the shop's own badge (-41%) when the card shows one; otherwise computed from the two prices. 11 of the 12 captured cards had a badge. -
seller:MediaMarkt Germany(the storefront itself) orMarketplace Seller. The capture split 6 and 6. -
ratingandreviewsCount: 5 of the 12 captured cards, all marketplace offers, show0 von 5 Sternenon the page and no reviews. In the row,ratingisnullandreviewsCountis0: null means no reviews yet, not a zero-star score. -
brand: the title's first word, capitalised (Samsung,Hp). -
availability: the delivery line, with the shop's date window.
Pro tips
- Mind which strike price you compare. A list price (
UVP) and a 30-day low are different baselines, so a 40% badge means different things on each. Split bysellerbefore averaging discounts. - Use a storefront word that titles contain. If rows are missing, read the run's rejection tally: a high
keywordcount means titles don't contain your term.notebookor a brand name may match better on German titles. - Sort on the site, filter in the Actor.
sortchanges what MediaMarkt returns first;minPrice,maxPrice,condition,brandand keyword filters drop rows after reading. PairPRICE_ASCwithmaxPriceso the rows inside your band come first. - Batch queries in one run. Put several terms in
searchQueries. A product kept under one term is not saved again under the next. - Start small. Keep
maxPages: 1andmaxItems: 20until your downstream code handles the fields, then raise them.
Troubleshooting
- Zero rows: a run that is blocked or cannot read a page ends FAILED; an over-strict filter or a term no title contains ends SUCCEEDED with an empty dataset and a status message saying so.
- Fewer rows than products on the page: read the summary line,
Run finished: pushed N records to dataset. Rejection tally: {...}; it counts drops per reason (duplicate,keyword,price,condition,brand,custom). From Python:client.log(run.id).get(). - Price filter left almost nothing: prices are in the storefront's currency;
maxPrice: 800means 800 PLN onPL. - Input refused before the run starts:
country,sortorconditionis not one of the listed values.
For help, use the Actor's Store page.
Pricing and next steps
For current pricing and details, see the Store page.
To track prices over time, save the input as a task and add an Apify schedule, which runs an Actor or task on a cron expression (0 8 * * * is every day at 8 AM). To react when a run finishes, add a webhook on ACTOR.RUN.SUCCEEDED; its payload carries the run object, including defaultDatasetId.
Which products or storefronts are you planning to track on MediaMarkt? Drop a comment! 💬
