By the end of this tutorial you will have a short Python script that searches heureka.cz for a keyword and prints one line per product: its name, its price range in CZK and its offer count.

Heureka.cz is a Czech site that lists products together with the shops offering them. Heureka.cz Scraper (reventadata/heureka-scraper) is the Apify Actor I built to read those product listings. You give it a keyword, and it returns one row per product. The sample rows below come from one example run on 2026-11-18, with the keyword iphone, not from an invented example. The Actor reads public pages with no login, so you send it only a keyword and a few limits.

Prerequisites

You need three things:

  1. Python 3.11 or newer. The Apify client for Python 3.x requires it.
  2. A free Apify account, which you can create with an email address or a GitHub login.
  3. Your Apify API token, from your account in Apify Console.

Install the client and export the token:

pip install -U "apify-client~=3.0" export APIFY_API_TOKEN="your_apify_token_here" 

No scraping code is needed on your side. The Actor reads public pages with no login, so you only send it a keyword.

What you'll achieve

You will search heureka.cz for iphone, cap the run at 10 products from the first results page, and print one line for each product.

Each row the Actor returns carries the product id, name and url, the lowest and highest price in CZK (minPrice and maxPrice), offerCount and shopCount, the review fields reviewRating and reviewCount, and the search that found it (searchQuery, page, searchUrl).

To search for something else, change the keyword in searchQueries. Nothing else in the script changes. The sample in Step 4 shows every field each row carries, and the explanations under Understanding your results say what each field holds.

Step 1: Open Heureka.cz Scraper

Open the Heureka.cz Scraper page on Apify Store. The code in this tutorial uses the Actor name reventadata/heureka-scraper.

Step 2: Choose the search

The search is described by these input fields:

  • searchQueries: one or more keywords, typed as in the heureka.cz search box. The run needs at least one. Each keyword is searched on its own, and a listing found under more than one keyword is kept once.
  • maxItems: the most rows the run saves. It defaults to 100.
  • maxPages: how many results pages to read per keyword, up to 835. It defaults to 5. Each page holds 24 to 29 items.
  • includeOffers: off by default. When it is on, the Actor also reads each product's own page for the shop offers, the full description and the producer. That makes the run slower.

The run in this tutorial uses this input:

{ "searchQueries": ["iphone"], "maxItems": 10, "maxPages": 1 } 

Step 3: Run it from Python

This script starts the Actor, waits for it to finish, reads the dataset and prints one line per product:

import os from apify_client import ApifyClient # 1. Initialise the client with your token from the environment client = ApifyClient(os.environ["APIFY_API_TOKEN"]) # 2. Describe the search: "iphone", 10 products from the first results page run_input = { "searchQueries": ["iphone"], "maxItems": 10, "maxPages": 1, } # 3. Start the Actor and wait for it to finish run = client.actor("reventadata/heureka-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. Read the rows from the run's default dataset items = client.dataset(run.default_dataset_id).list_items().items print(f"Retrieved {len(items)} products.\n") # 5. Print one line per product: name, price range in CZK, offer count for item in items: print(f"{item['name']}: {item['minPrice']} to {item['maxPrice']} CZK, {item['offerCount']} offers") 

Run against the example run's 10 rows, the last loop prints this:

Retrieved 10 products. Apple iPhone 17 256GB Black: 21996 to 34065 CZK, 43 offers Apple iPhone 18 Pro 256GB Burgundy: 32786 to 58333 CZK, 32 offers Apple iPhone 17 Pro 256GB Cosmic Orange: 27590 to 40262 CZK, 31 offers Apple iPhone 17 Pro 256GB Silver: 28200 to 34250 CZK, 16 offers Apple iPhone 17 Pro 256GB Deep Blue: 26990 to 39990 CZK, 24 offers Apple iPhone 15 128GB Black: 15689 to 18980 CZK, 19 offers Apple iPhone 18 Pro Max 256GB Burgundy: 37536 to 43999 CZK, 18 offers Apple iPhone 17 256GB Lavender: 21762 to 34197 CZK, 45 offers Apple iPhone 18 Pro 256GB Black: 32490 to 45874 CZK, 37 offers Apple iPhone 17 256GB White: 22184 to 27159 CZK, 38 offers 

Step 4: Read the rows

The first row of the same run, copied as the Actor returned it, with nothing removed:

{ "id": "1400243071", "name": "Apple iPhone 17 256GB Black", "slug": "apple-iphone-17-256gb-black", "url": "https://mobilni-telefony.heureka.cz/apple-iphone-17-256gb-black/", "minPrice": 21996, "maxPrice": 34065, "price": null, "currency": "CZK", "offerCount": 43, "shopCount": 37, "categoryId": "731", "categorySlug": "mobilni-telefony", "categoryName": "Mobilní telefony", "reviewRating": 91, "reviewCount": 115, "topBadge": null, "description": "Tento smartphone se zaoblenými hranami a tenkými okraji se pyšní skvělým výkonem, pokročilou fotosoustavou i odolným provedením.", "imageUrl": "https://img-cdn.heureka.group/v1/p/6a8c86ca-8e3f-5e37-a1a7-2a98f324a2fa.jpg?width=400&height=400", "isAd": false, "producer": null, "fullDescription": null, "images": null, "offers": null, "searchQuery": "iphone", "page": 1, "searchUrl": "https://www.heureka.cz/?h%5Bfraze%5D=iphone&f=1", "scrapedAt": "2026-11-18T07:49:50.000Z" } 

Step 5: Download the results

The dataset can be downloaded as JSON, CSV or Excel, among other formats, from the run's output. Full list: the dataset docs.

Understanding your results

Each row has these fields:

  • name, url, slug and id: the product title, its product page on heureka.cz, the URL slug and the product ID.
  • minPrice and maxPrice: the lowest and highest price in CZK for the product. In this run they are whole numbers, such as 21996 and 34065 on the first row.
  • price: empty (null) on all 10 rows of this run.
  • offerCount and shopCount: the number of offers and the number of distinct shops, as the site lists them. The first row has 43 offers from 37 shops.
  • reviewRating and reviewCount: the rating as a whole number, and the number of reviews. The first row has 91 and 115.
  • topBadge: empty on all 10 rows of this run.
  • producer, fullDescription, images and offers: empty on all 10 rows, because includeOffers was off in this run.
  • isAd: false on all 10 rows of this run.
  • scrapedAt: the same timestamp on every row of this run.

Pro tips

  1. Keep maxItems small while you test. It caps the rows saved, so a test run costs less time and gives you a short file to read.
  2. Raise maxPages only when you need more than the first page. Each page holds 24 to 29 items. The example used one page.
  3. Leave includeOffers off unless you need offers. Turning it on reads each product's page too, which makes the run slower.
  4. Use several keywords for one table. A listing found under two keywords is kept once, so the table has no repeats.
  5. Read offerCount and shopCount together. Both come from the listing as the site shows them.
  6. Mind the page ceiling. The Actor stops at page 835, so maxPages above that is capped.
  7. Read the empty fields first. On the example run, price, topBadge and the detail fields were empty on every row, so a column that looks blank may be blank for the whole run.

Troubleshooting common issues

  • Zero rows, status SUCCEEDED. The site answered and nothing matched. The run's status message says so. Check the keyword against the heureka.cz search box.
  • Zero rows, status FAILED. The input has no keyword, or a page could not be read, so matches may have been missed. The status message names the cause. Fix the input or run again.
  • Fewer rows than maxItems. The search had fewer matches within maxPages, or a listing repeated across pages was skipped. The run log lists the skipped counts and their reasons.

The run log and the status message are in Apify Console, on the run's page.

Next steps

To repeat a search, save it as an Apify task and attach a schedule, which runs an Actor or task on a cron expression.

For current pricing and details, see the Store page.

What will you search for on heureka.cz? Drop a comment! 💬

About the author: reventadata builds and publishes data extraction Actors on the Apify Store.