# Heureka Scraper - Czech Price Comparison & Deals (`studio-amba/heureka-scraper`) Actor

Scrape product prices and deals from Heureka.cz, the largest price comparison site in Czech Republic. Compare prices across Czech retailers, extract ratings, reviews, and offers. No login or cookies required.

- **URL**: https://apify.com/studio-amba/heureka-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 19 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Heureka Scraper — Czech Price Comparison, Product Deals & Offers

Scrape **product prices, deals, and offers from Heureka.cz** — the largest price comparison site in Czech Republic and Slovakia with over 50 million monthly visits. Compare prices across Czech retailers, extract ratings, reviews, and offers for any product category. No login or cookies required.

Run this Actor on [Apify](https://apify.com) to get structured price comparison data via API, schedule regular price monitoring, and integrate with your tools through webhooks, Zapier, or Make.

### Why use Heureka Scraper?

- **Price monitoring** — Track the lowest prices for products across all Czech online shops listed on Heureka.cz
- **Market research** — Compare pricing, ratings, and availability across the Czech Republic's largest comparison platform
- **Competitive intelligence** — See which shops offer the best deals and how many sellers compete per product
- **E-commerce analytics** — Analyze pricing trends, price ranges, and consumer ratings at scale in the Czech market
- **Deal discovery** — Find the best offers across thousands of Czech and Slovak retailers

### How to scrape Heureka data

1. Go to the **Input** tab and enter a search query (e.g., "notebook", "televize", "iPhone 16")
2. Optionally set maximum results and proxy configuration
3. Click **Start** and wait for the Actor to finish
4. Download your data from the **Output** tab in JSON, CSV, Excel, or other formats

You can also provide a direct Heureka category URL (e.g., `https://notebooky.heureka.cz/`) to scrape an entire product category instead of using search.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Search term in Czech or English (e.g., "notebook", "televize", "Samsung TV") |
| `categoryUrl` | String | No | Full Heureka category URL to scrape. Overrides search query if provided. |
| `maxResults` | Integer | No | Maximum products to return (default: 100, max: 10,000) |
| `proxyConfiguration` | Object | No | Proxy settings. Czech residential proxies recommended for reliable scraping. |

If both `searchQuery` and `categoryUrl` are empty, the actor defaults to searching for "notebook".

### Output

Each result contains comprehensive price comparison data:

| Field | Type | Example |
|-------|------|---------|
| `name` | String | `"Lenovo IdeaPad 5 15ALC05"` |
| `brand` | String | `"Lenovo"` |
| `price` | Number | `14990` |
| `currency` | String | `"CZK"` |
| `originalPrice` | Number | `17990` (price before the discount; null when not discounted) |
| `highestPrice` | Number | `21714` (dearest offer across the shops that stock it) |
| `discountPercentage` | Number | `19` |
| `numberOfOffers` | Number | `23` |
| `shopCount` | Number | `21` |
| `rating` | Number | `97` (percent, the scale Heureka publishes) |
| `reviewCount` | Number | `87` |
| `imageUrl` | String | Primary product image URL |
| `productUrl` | String | Full Heureka product page URL |
| `category` | String | `"Notebooky"` |
| `description` | String | Short product description |
| `url` | String | Source search/category page URL |
| `scrapedAt` | String | `"2026-05-27T10:30:00.000Z"` |

### Example output

```json
{
    "name": "Apple MacBook Air M3 256GB",
    "brand": "Apple",
    "price": 27990,
    "currency": "CZK",
    "originalPrice": null,
    "highestPrice": 32990,
    "discountPercentage": null,
    "numberOfOffers": 35,
    "shopCount": 31,
    "rating": 98,
    "reviewCount": 156,
    "imageUrl": "https://im9.cz/iR/importedm/heureka/product-detail/macbook-air-m3.jpg",
    "productUrl": "https://www.heureka.cz/apple-macbook-air-m3-256gb/",
    "category": "Notebooky",
    "description": "Apple MacBook Air s cipem M3, 13.6\" Liquid Retina displej, 8GB RAM, 256GB SSD",
    "url": "https://www.heureka.cz/vysledky-hledani/?q=macbook",
    "scrapedAt": "2026-05-27T10:30:00.000Z"
}
```

### How much does it cost to scrape Heureka?

This Actor is priced per result: **0.005 USD per product**, plus 0.01 USD per GB when the run starts. There is no separate proxy bill — unblocking is included in the per-result price.

- **20 products**: ~0.11 USD
- **100 products**: ~0.51 USD
- **1,000 products**: ~2.51 USD
- **10,000 products**: ~25.01 USD

A run's usage cost only settles once the run reports SUCCEEDED. Reading the dataset while the run is still going shows a cost far below the final one, so check the total after the run finishes. The Apify Free plan includes 5 USD/month of platform usage.

### Tips for best results

- **Use Czech residential proxies** — Heureka blocks datacenter IPs. Czech residential proxies are strongly recommended for reliable scraping
- **Search in Czech** — For best results, use Czech search terms: "notebook" works, but "televize" will give better results than "television"
- **Start small** — Test with `maxResults: 10` before running large scrapes
- **Use category URLs** — For targeted scraping, paste a full Heureka category URL (e.g., `https://notebooky.heureka.cz/`) instead of a search query
- **Schedule regular runs** — Set up scheduled runs for ongoing price monitoring in the Czech market

### Use cases

- **Price tracking** — Monitor product prices across Czech e-shops and get alerts when prices drop
- **Market entry research** — Understand Czech market pricing before launching products in Czech Republic
- **Competitor monitoring** — Track how competitors price products on Heureka.cz
- **Data journalism** — Analyze pricing trends in the Czech consumer electronics market
- **Academic research** — Study e-commerce pricing dynamics in Central Europe

### FAQ and support

**Is it legal to scrape Heureka?** This Actor extracts publicly available data from Heureka.cz. Always review and comply with the website's Terms of Service before using.

**Why am I getting no results?** If Heureka itself shows no products for your search term or category, the run succeeds with 0 items and says so in the status message. If a page could not be read after several retries, the run fails and the status message names the page. Try a Czech search term ("pračka" instead of "washing machine").

**How does pagination work?** Heureka shows 24 products per page. Many searches (for example "notebook" or "televize") open a category page on Heureka, and the Actor then pages through that category. Each product is returned once per run, even when Heureka repeats a promoted product on the next page.

**What happens with a very large maxResults?** The Actor stops fetching new pages shortly before the run timeout and finishes with the products it already has. The status message says it stopped early. Raise the run timeout if you need more products in one run.

**What about Heureka.sk?** This Actor is optimized for Heureka.cz (Czech market). Slovak Heureka support may be added in a future version.

**Can I scrape product detail pages?** Currently the Actor scrapes search result and category listing pages. Individual product detail pages with full specifications may be added in a future version.

For issues or feature requests, please open an issue on the Actor page or contact support.

# Actor input Schema

## `searchQuery` (type: `string`):

Search term in Czech or English (e.g. 'notebook', 'iPhone 16', 'televize'). Leave empty when using category URLs.

## `categoryUrl` (type: `string`):

Full Heureka category URL (e.g. 'https://notebooky.heureka.cz/'). Overrides search query if provided.

## `maxResults` (type: `integer`):

Maximum number of products to scrape.

## `proxyConfiguration` (type: `object`):

Proxy settings. Czech residential proxies are strongly recommended — Heureka blocks datacenter IPs.

## Actor input object example

```json
{
  "searchQuery": "notebook",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "notebook",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CZ"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/heureka-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "notebook",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CZ",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/heureka-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "notebook",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}' |
apify call studio-amba/heureka-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/heureka-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZsdYVoi1VbUz8vuwq/builds/rKd5WtslYRYWcbGfG/openapi.json