# Czech E-shop Price Comparison: Alza, Datart, Smarty & more (`tsutseisoftware/czech-eshop-aggregator`) Actor

Compare a product's price across 9 Czech e-shops in one run: Alza, Datart, TS Bohemia, Smarty, Planeo, Mironet, OnlineShop, Mobil Pohotovost, iSTYLE. Search, EAN, MPN or a product link; one row per product with the lowest price, price per shop, stock, monitoring, alerts. Unofficial.

- **URL**: https://apify.com/tsutseisoftware/czech-eshop-aggregator.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 90.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.20 / 1,000 product (price comparison)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Czech E-shop Price Comparison: Alza, Datart, Smarty & more

Compare the price of a product across **nine Czech e-shops in one run**: **Alza.cz**, **Datart.cz**, **TSBOHEMIA.CZ**, **Smarty.cz**, **Planeo.cz**, **Mironet.cz**, **OnlineShop.cz**, **Mobil Pohotovost (mp.cz)** and, for Apple products, **iSTYLE.cz**. Search once (e.g. `iphone 17 256gb`), give your **EANs** or **manufacturer part numbers (MPN)**, or paste a **product link from any of the shops**, and get **one row per product** with the **lowest price and its shop**, the **price in every shop** as its own column, stock, the price spread and every offer with its link. Built for pricing teams, catalogue monitoring and affiliate sites.

Prices come **straight from the shops**, read at the moment of the run, not from a price comparison site's copy that can be hours old (see [below](#price-comparison-sites-vs-the-shops-themselves)).

> **Česky:** Srovnání cen v **devíti českých e-shopech v jednom běhu**: Alza, Datart, TS Bohemia, Smarty, Planeo, Mironet, OnlineShop, Mobil Pohotovost a iSTYLE (Apple). Zadáte hledání, EAN, kód výrobce nebo odkaz na produkt z kteréhokoli obchodu a dostanete **jeden řádek za produkt**: nejnižší cenu a obchod, cenu v každém e-shopu ve vlastním sloupci, dostupnost a všechny nabídky s odkazy. Ceny přímo z obchodů, hlídání cen konkurence, upozornění do Telegramu, Slacku, Discordu nebo WhatsAppu. Výstup do Excelu, CSV nebo JSON. Podporu poskytujeme i česky.

### Why use this Czech e-shop price comparison?

- 🛒 **Nine Czech shops at once, read at the same time.** No other Apify actor compares Czech e-shops directly. Each shop is read with the same filters, politeness and data quality as our own single-shop scraper; a run takes about as long as its slowest shop.
- 🔗 **The same product matched across shops** by **EAN** or **MPN**: one row with `shops`, `offerCount` and every offer. Offers are matched even when shops show different codes for the same product.
- 🔎 **Search, EAN, MPN or a product link.** Paste an Alza (or any other shop's) product page and the actor finds the same product in the other shops. One product looked up in all nine shops costs about **$0.03**.
- 💰 **Price comparison in columns:** `lowestPrice`, `lowestPriceShop`, `highestPrice`, `priceSpreadPercent`, the lowest price **in stock**, and `priceAlza`, `priceDatart`, `priceTsbohemia`, `priceSmarty`, `pricePlaneo`, `priceMironet`, `priceOnlineshop`, `priceMobilPohotovost`, `priceIstyle`, ready for Excel or Google Sheets. **New goods only** by default, so the prices compare the same thing.
- 📬 **Monitoring with notifications:** a daily list of products whose lowest price, cheapest shop, stock or price in any shop changed, sent to Telegram, Slack, Discord, WhatsApp or any webhook ($0.001 per run that sent one), plus a free **summary** (`SUMMARY`): how often each shop was the cheapest and how much prices differ.
- 💸 **No extra platform costs:** compute and proxies are included in the price.

### Shops

| Shop | `shops` value | Price per 1 000 offers | With details | Lookup by (price) | Read by default |
|---|---|---|---|---|---|
| Alza.cz | `alza` | $2.89 | included | MPN | yes |
| Datart.cz | `datart` | $0.95 | +$1.65 | EAN (+$1.75) | yes |
| TSBOHEMIA.CZ | `tsbohemia` | $0.95 | +$0.85 | EAN, MPN (+$1.90) | yes |
| Smarty.cz | `smarty` | $0.95 | +$0.85 | EAN (+$0.40) | yes |
| Planeo.cz | `planeo` | $0.95 | included | EAN | yes |
| Mironet.cz | `mironet` | $0.95 | included | EAN, MPN | yes |
| OnlineShop.cz | `onlineshop` | $1.75 | +$0.75 | EAN (+$0.80, product page included) | yes |
| Mobil Pohotovost (mp.cz) | `mobil-pohotovost` | $1.75 | included | EAN, MPN (+$0.40) | yes |
| iSTYLE.cz (Apple) | `istyle` | $1.75 + $0.0025 per list page | included | EAN, MPN | no, add it for Apple products |

Every offer pays the price of the shop's own scraper on Apify, so comparing never costs less per shop than scraping it alone (and no more). Each shop reads up to **Max products per shop** (by default its share of **Max products**: Max products ÷ number of shops + 20 %). Products found in several shops are saved first.

**iSTYLE.cz** sells only Apple products, and a search term there costs about $0.06 in list pages (as in its own scraper), so it is not in the default shops. EAN and MPN lookups there are cheap (a lookup without a product $0.001).

### How to compare prices across Czech e-shops

1. Choose the **Shops** (empty = the eight general shops).
2. Type **Search terms** (e.g. `iphone 17 256gb`, `lg oled55c5`, `rtx 5070`), give **EANs** and **MPNs**, or paste **Product or category URLs** of the shops.
3. For searches, turn on **Add details (EAN, MPN, parameters)**: matching across shops needs the EAN or MPN. Without **Add details**, searches are matched in fewer shops; EAN and MPN lookups always match.
4. Optionally filter by price, brand, words in the name, stock or discount, and choose the order (**Sort by** most shops, lowest or highest price, or the biggest price difference).
5. Run it and export the dataset to Excel, CSV or JSON, or get it through the API.

#### Product links

Paste a product page of any of the shops (e.g. `https://www.alza.cz/iphone-17-256gb-cerna-d13078770.htm`). The shop reads it first, then the product is found in the other chosen shops by its codes. One link, the price everywhere. Category and search pages of a shop work too (turn on **Add details** where the shop shows the codes only on the product page). Turn off **Look up the products of the URLs in the other shops** to read just the URLs.

#### Matching

Offers are the same product when they share an **EAN** or a **manufacturer part number** (formatting and regional variants are handled). Offers without either are never matched: product names differ too much between shops (colours, word order, "černý" vs "Black") to join them safely. **One row per product** can be turned off to get one row per offer.

#### Monitoring mode

Turn on **Monitoring: only new or changed products** and schedule the actor. Each run returns only products that are new or whose `lowestPrice`, `lowestPriceShop`, shops, number of shops in stock or price in any shop changed since the last run with the same **Monitoring key**, with `changeType` and `changedFields`. Unchanged products are not saved; their offers pay only a small check fee (see the price list below).

#### Notifications

Set a Telegram bot, a Slack or Discord webhook, WhatsApp (access token, business phone number ID and the recipient's number) or any HTTPS webhook. After the run you get the product names with the lowest price, shop and link (in monitoring mode only the changed ones). Nothing is sent when nothing was saved, unless you turn that off.

#### Compact output

**Compact output** saves only the comparison: `id`, `name`, `brand`, `ean`, `mpn`, `shopCount`, `shops`, the lowest price with its shop and link, `highestPrice`, `priceSpreadPercent`, the lowest price in stock and the price columns of every shop. Good for spreadsheets, AI agents and MCP clients.

### How much does it cost?

Pay per result; a typical run costs a few cents (see the examples). Every saved product pays:

1. the price of **each of its offers** in its shop (the table above, the same as the shop's own scraper: an offer with its product page pays the shop's detail price, an offer found by a lookup the shop's lookup price), and
2. the **comparison** (matching, price columns, monitoring across shops): **$0.30 per 1 000 products** ($0.28 Bronze, $0.25 Silver, $0.20 Gold and higher plans).

| Example (FREE plan, from runs on Apify on 12 November 2026) | Price |
|---|---|
| The prefilled input: "iphone 17 256gb" in Planeo and Mobil Pohotovost with details, 9 products from 16 offers (7 compared) | **$0.034** |
| One iPhone by EAN and MPN in all nine shops: found in Alza, TS Bohemia, Smarty, Mobil Pohotovost and iSTYLE | **$0.026** |
| A link to an Alza product, found in TS Bohemia, Smarty and Mobil Pohotovost | **$0.023** |
| 1 000 offers from Mironet only | $0.95 + $0.30 per 1 000 = **$1.25** |

**Start: $0.01 per run** (starting and reading up to nine shops). Notifications: **$0.001 per run** that sent one. **iSTYLE.cz** also pays its own events, as in its scraper: **$0.0025 per list page** (about $0.06 per search term) and **$0.001 per EAN or MPN looked up there without a product**; with **iSTYLE.cz: retry rejected requests from a new IP address** on, **$0.003 for every new IP address**.

**Check fees** (`monitoring-check` event, $0.00001 per unit; a normal run pays little or nothing here):

| Shop | Offer not saved (monitoring, "Only products in several shops"), per 1 000 offers: listed / with details / found by a lookup | Extra pages (a narrow filter, a search without results, codes not found), per 1 000 pages |
|---|---|---|
| Alza | $0.30 | $1.60 |
| Datart | $0.10 / +$1.15 / +$1.70 | $1.70 |
| TS Bohemia | $0.05 / +$0.10 / +$0.35 | $0.30 |
| Smarty | $0.05 / +$0.50 / +$0.60 | $0.70 |
| OnlineShop | $0.03 / +$0.40 / +$0.50 | $0.60 |
| iSTYLE | $0.01 / +$0.10 / +$0.30 | (its own list page fee) |
| Planeo, Mironet | $0.02 / +$0.10 / +$0.10 | $0.10 |
| Mobil Pohotovost | $0.02 / +$0.10 / +$0.10 | $0.20 |

A product that is not saved always costs much less than saving it. If the saved items don't cover a run's cost (e.g. a shop answered very slowly or kept rejecting requests), the difference is charged as small check units; the log says how many. A normal run pays nothing more. Filtered-out offers and the `SUMMARY` record are free. You can set a maximum cost per run: the run never goes over it and saving stops when it is reached. The log ends with the list of everything charged in the run.

### Input examples

**Affiliate or content site:** search with details in the default shops:

```json
{
  "searchQueries": ["iphone 17 256gb"],
  "includeDetails": true,
  "maxItems": 30,
  "maxItemsPerShop": 5
}
```

**Catalogue monitoring:** lookup of your catalogue in all nine shops:

```json
{
  "shops": ["alza", "datart", "tsbohemia", "smarty", "planeo", "mironet", "onlineshop", "mobil-pohotovost", "istyle"],
  "eans": ["0195950643534"],
  "mpns": ["MG6J4SX/A"],
  "onlyInSeveralShops": true
}
```

**Pricing against Alza:** the price of one Alza product everywhere:

```json
{
  "startUrls": [{ "url": "https://www.alza.cz/iphone-17-256gb-cerna-d13078770.htm" }]
}
```

**Daily price watch** with a Telegram message:

```json
{
  "eans": ["0195950643534", "0195950644135"],
  "onlyNewOrChanged": true,
  "monitoringKey": "my-catalogue",
  "telegramBotToken": "123456:ABC...",
  "telegramChatId": "-1001234567890"
}
```

### Output example

```json
{
  "id": "cz-eshops:5c9e0abdbc45208d",
  "matchKey": "ean:00195950643534",
  "matchedBy": "ean",
  "name": "iPhone 17 256GB černá",
  "brand": "Apple",
  "ean": "0195950643534",
  "mpn": "MG6J4SX/A",
  "currency": "CZK",
  "offerCount": 5,
  "shopCount": 5,
  "shops": ["alza", "tsbohemia", "smarty", "mobil-pohotovost", "istyle"],
  "lowestPrice": 24490,
  "lowestPriceShop": "istyle",
  "lowestPriceUrl": "https://istyle.cz/products/iphone-17-mg6j4sx-a",
  "highestPrice": 24690,
  "priceSpread": 200,
  "priceSpreadPercent": 0.8,
  "inStockShopCount": 5,
  "lowestInStockPrice": 24490,
  "lowestInStockShop": "istyle",
  "priceAlza": 24690,
  "priceDatart": null,
  "priceTsbohemia": 24690,
  "priceSmarty": 24590,
  "pricePlaneo": null,
  "priceMironet": null,
  "priceOnlineshop": null,
  "priceMobilPohotovost": 24590,
  "priceIstyle": 24490,
  "offers": [
    {"shop": "istyle", "url": "https://istyle.cz/products/iphone-17-mg6j4sx-a", "price": 24490, "priceBeforeDiscount": 25990, "availability": "in_stock", "inStock": true, "ean": "0195950643534", "mpn": "MG6J4SX/A", "matchedBy": "mpn"},
    {"shop": "smarty", "url": "https://www.smarty.cz/Apple-iPhone-17-256GB-cerny-4p240082", "price": 24590, "priceBeforeDiscount": 25990, "availability": "in_stock", "inStock": true, "ean": "0195950643534", "mpn": "MG6J4SX/A", "matchedBy": "ean"}
  ],
  "searchQuery": "MG6J4SX/A",
  "scrapedAt": "2026-11-12T08:49:29Z"
}
```

From a run on Apify on 12 November 2026 (offers shortened). See the **Output** tab for all fields. The dataset has views **Price comparison**, **Stock**, **Matching** and **Monitoring**.

### Price comparison sites vs. the shops themselves

Scrapers of Heureka or Zboží.cz return what the comparison site shows: its own copy of the shops' prices, often hours old, for the shops that pay to be listed. This actor reads the shops' own pages at the moment of the run, so you get the price, stock, coupon and the shop's own product page, the EAN or MPN to match your catalogue by, monitoring with notifications, and a row per product with a column per shop. It covers nine big Czech shops, not every shop on Heureka.

### Limitations

- Each shop searches its own way, so the same search finds different products in each shop; with **Max products per shop** small, a shop may return other variants than the others. **Max pages per search** sets how many result pages each shop reads per search term (up to each shop's own maximum; empty = the shop's default).
- Matching needs an EAN or MPN. Without **Add details**, searches are matched in fewer shops; lookups always match.
- Alza shows no EANs (EAN lookups skip it; give the MPN too). Datart, Smarty, Planeo and OnlineShop have no MPN lookup. Mironet shows no EAN, so its offers match by MPN.
- Since November 2026 Mironet.cz product pages can't be read, so Mironet offers come with the list data only (price, stock), without the MPN and parameters, and Mironet lookups by EAN or MPN currently find nothing. Nothing is solved or bypassed.
- A shop's search may not know an EAN (it then reports it as not found); the product can still be found by a search term.
- A shop that cannot be read (blocked, website change) is named in the status message and the others are saved; a shop stopped early keeps the products it read.
- Near the run's timeout the shops stop reading (keeping time to save and charge what was read); a run restarted by the platform (migration) usually doesn't read again the shops it had already finished.
- Prices are with VAT in CZK, as shown on the website for a new item; coupons and cashback are in each offer (`couponCode`, `couponPrice`), not in the lowest price.

### For AI agents and API users

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("tsutseisoftware/czech-eshop-aggregator").call(run_input={
    "eans": ["0195950643534"], "mpns": ["MG6J4SX/A"],
})
for p in client.dataset(run.default_dataset_id).iterate_items():
    print(p["name"], p["lowestPrice"], p["lowestPriceShop"], p["shops"])
```

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### More Czech & Slovak e-shop scrapers

Compare prices across Czech and Slovak shops with the same output format (EAN for matching, monitoring mode):

- [Datart.cz Scraper](https://apify.com/tsutseisoftware/datart-scraper): electronics: prices, 30-day low, EAN, store availability
- [TSBOHEMIA.CZ Scraper](https://apify.com/tsutseisoftware/tsbohemia-scraper): IT & electronics: prices, discount codes, EAN, site filters
- [Planeo.cz Scraper](https://apify.com/tsutseisoftware/planeo-scraper): electronics & appliances: prices, discount codes, store pickup, EAN
- [Smarty.cz Scraper](https://apify.com/tsutseisoftware/smarty-scraper): electronics: prices, coupons, cashback, EAN, price history, store stock
- [BAUHAUS.cz Scraper](https://apify.com/tsutseisoftware/bauhaus-cz-scraper): DIY & garden: prices, unit prices, stock in 9 stores, variants, EAN
- [Mironet.cz Scraper](https://apify.com/tsutseisoftware/mironet-scraper): electronics: prices, store stock, delivery date, MPN, warranty, price history
- [Alza Scraper (CZ, SK, HU, AT, DE)](https://apify.com/tsutseisoftware/alza-scraper): electronics: prices, coupons, ratings, reviews, pickup points, MPN
- [NAY.sk Scraper (Slovakia)](https://apify.com/tsutseisoftware/nay-sk-scraper): electronics: prices in EUR, discount codes, stock in 54 stores, EAN
- [BAUHAUS.sk Scraper (Slovakia)](https://apify.com/tsutseisoftware/bauhaus-sk-scraper): DIY & garden: EUR prices, Bratislava store stock, variants, EAN
- [Planeo.sk Scraper (Slovakia)](https://apify.com/tsutseisoftware/planeo-sk-scraper): electronics & appliances: EUR prices, discount codes, cashback, stock in 69 stores, EAN
- [TSBOHEMIA.SK Scraper (Slovakia)](https://apify.com/tsutseisoftware/tsbohemia-sk-scraper): IT & electronics: EUR prices, discount codes, EAN, lookups
- [Smarty.sk Scraper (Slovakia)](https://apify.com/tsutseisoftware/smarty-sk-scraper): electronics: EUR prices, coupons, cashback, stock in Slovak stores, EAN
- [OnlineShop.cz Scraper](https://apify.com/tsutseisoftware/onlineshop-scraper): electronics & appliances: prices, 30-day low, discount codes, EAN, stock
- [Mobil Pohotovost Scraper](https://apify.com/tsutseisoftware/mobil-pohotovost-scraper): phones, tablets and watches, new, like new and used: prices, EAN, MPN, condition, stock, monitoring
- [iSTYLE.cz Scraper](https://apify.com/tsutseisoftware/istyle-scraper): Apple products: prices, EAN, Apple part number, open-box and refurbished offers, stock, monitoring

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape Czech e-shops?

The actor reads only publicly available data, without logging in, at most 30 requests per minute per shop, slows down when a website asks and never solves captchas or other challenges. It returns no personal data. The websites' terms of use may limit automated access, and you are responsible for how you use the data (database rights and the websites' terms). This actor is not affiliated with any of the shops.

#### Why is a product not matched with the same product in another shop?

Matching needs the same EAN or MPN. Turn on **Add details** for searches (most shops show the EAN or MPN only on the product page). Some shops use another part number for the same product (e.g. a regional variant), and some products have several EANs.

#### Why is iSTYLE.cz not read by default?

It sells only Apple products, and a search term there costs about $0.06 in list pages, like its own scraper. Add `istyle` to **Shops** for Apple products, or look products up there by EAN or MPN, which is cheap.

#### What does "retry rejected requests from a new IP address" do?

iSTYLE.cz sometimes answers with a verification page instead of data. With the option on, a rejected request is repeated from a new proxy address, **$0.003 per new address used**. Nothing is solved or bypassed. Off (the default here), iSTYLE.cz may end without products; the other shops are not affected.

#### How long does a run take?

The shops are read at the same time, so a run takes about as long as its slowest shop. The prefilled input takes about 40 seconds, a lookup of one product in all nine shops about 30 seconds. The log says at the start which shop is the slowest and how long it needs, and once a minute which shops are done.

#### Can I get one shop only?

Yes, choose one shop; you pay its price plus the comparison. For one shop its own scraper is cheaper and has more options, e.g. [Alza Scraper](https://apify.com/tsutseisoftware/alza-scraper), [Datart.cz Scraper](https://apify.com/tsutseisoftware/datart-scraper) or [Mironet.cz Scraper](https://apify.com/tsutseisoftware/mironet-scraper).

***

Also known as a Czech price comparison API, "srovnání cen e-shopů", "srovnání cen elektroniky", "hlídač cen konkurence" or "porovnání cen Alza Datart".

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/czech-eshop-aggregator/changelog.md

# Actor input Schema

## `shops` (type: `array`):

Shops to read, all at the same time. Empty = the 8 general shops (all but iSTYLE.cz, which sells only Apple and costs about $0.06 per search term in list pages: add it for Apple products). Every offer pays the price of its shop's own scraper; proxies are included.

## `searchQueries` (type: `array`):

Searched in every shop like in its search box, e.g. "iphone 17 256gb", "lg oled55", "rtx 5070". At most 10. Matching across shops needs EAN or MPN, so turn on "Add details" for searches.

## `eans` (type: `array`):

EAN barcodes (check digit verified). Looked up in Datart, TS Bohemia, Smarty, Planeo, Mironet, OnlineShop, Mobil Pohotovost and iSTYLE (Alza does not show EANs: give the MPN too). One row per EAN with every shop that sells it.

## `mpns` (type: `array`):

MPNs, e.g. "MG6J4SX/A". Looked up in Alza, TS Bohemia, Mironet, Mobil Pohotovost and iSTYLE. At most 100 EANs and MPNs together.

## `startUrls` (type: `array`):

Product, category or search pages of the shops above (e.g. an Alza product page). Each is read by its own shop; then the products found are looked up in the other chosen shops by their codes, so one link gives the price everywhere. Category pages: turn on "Add details" for matching. At most 50.

## `compareStartUrls` (type: `boolean`):

Off = only the URLs' own shops are read.

## `maxItems` (type: `integer`):

Maximum number of products saved (after matching across shops). 0 = no limit.

## `maxItemsPerShop` (type: `integer`):

How many products each shop reads at most. 0 = its share of "Max products" (Max products ÷ number of shops + 20 %). With EANs or MPNs at least the number of codes.

## `maxPagesPerSearch` (type: `integer`):

How many result pages each shop reads per search term (up to each shop's own maximum). Empty or 0 = the shop's default. Raise it for narrow filters; pages beyond what the saved offers explain (pages thrown away by a filter, EANs and MPNs not found) pay a small fee per 1 000 (Datart $1.70, Alza $1.60, Smarty $0.70, OnlineShop $0.60, TS Bohemia $0.30, Mobil Pohotovost $0.20, Planeo and Mironet $0.10). iSTYLE.cz pays its own list pages ($0.0025 each).

## `minPrice` (type: `integer`):

Only offers from this price.

## `maxPrice` (type: `integer`):

Only offers up to this price.

## `onlyNew` (type: `boolean`):

Leave out used, open-box ("rozbalené"), like-new and refurbished offers, so prices compare the same thing.

## `onlyInStock` (type: `boolean`):

Only offers in stock.

## `onlyDiscounted` (type: `boolean`):

Only discounted offers.

## `minDiscountPercent` (type: `integer`):

Only offers with at least this discount.

## `brands` (type: `array`):

Only these brands, e.g. "Apple", "Samsung".

## `excludeBrands` (type: `array`):

Leave out these brands.

## `nameKeywords` (type: `array`):

Only offers whose name contains one of these words.

## `excludeNameKeywords` (type: `array`):

Leave out offers whose name contains one of these words (e.g. "kryt", "pouzdro").

## `includeDetails` (type: `boolean`):

Open each product page for the EAN, MPN, warranty and parameters, so the same product is matched across shops. Slower; Datart +$1.65, TS Bohemia and Smarty +$0.85, OnlineShop +$0.75 per 1 000 offers with details (Alza, Planeo, Mironet, Mobil Pohotovost and iSTYLE free). EAN and MPN lookups always have them.

## `retryFromNewIp` (type: `boolean`):

iSTYLE.cz sometimes answers with a verification page instead of data. On: a rejected request is repeated from a new proxy address, $0.003 per new address used (new-ip-retry). Off: iSTYLE.cz may end without products (the other shops are not affected). Nothing is solved or bypassed.

## `mergeProducts` (type: `boolean`):

Offers with the same EAN or MPN become one row with the lowest price, the price in each shop and all offers. Off = one row per offer.

## `onlyInSeveralShops` (type: `boolean`):

Save only products offered by at least two shops (the price comparison). The others are not saved and pay only a small check fee (see the README).

## `compactOutput` (type: `boolean`):

Only the comparison (name, brand, EAN, MPN, shops, lowest price and shop, price in each shop) without the offers and parameters. Smaller rows for spreadsheets, AI agents and MCP clients.

## `sortBy` (type: `string`):

Order of the products in the dataset (before "Max products" is applied). Empty = most shops first; lookups keep the order of your codes.

## `onlyNewOrChanged` (type: `boolean`):

Return only products that are new or whose lowest price, cheapest shop, shops, stock or price in a shop changed since the previous run with the same Monitoring key. Unchanged products are not saved and pay only a small check fee per offer (see the README).

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for each list you monitor.

## `telegramBotToken` (type: `string`):

Token of your Telegram bot (from @BotFather). Used with "Telegram chat ID".

## `telegramChatId` (type: `string`):

Chat, group or channel ID the bot writes to (e.g. -1001234567890).

## `slackWebhookUrl` (type: `string`):

Incoming webhook of your Slack channel (https://hooks.slack.com/services/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL: gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many products are listed in one notification (the rest as "…and N more").

## `notifyOnlyChanges` (type: `boolean`):

Send nothing when the run saved no product (e.g. a monitoring run without changes).

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "shops": [
    "planeo",
    "mobil-pohotovost"
  ],
  "searchQueries": [
    "iphone 17 256gb"
  ],
  "compareStartUrls": true,
  "maxItems": 20,
  "maxItemsPerShop": 8,
  "onlyNew": true,
  "onlyInStock": false,
  "onlyDiscounted": false,
  "includeDetails": true,
  "retryFromNewIp": false,
  "mergeProducts": true,
  "onlyInSeveralShops": false,
  "compactOutput": false,
  "onlyNewOrChanged": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "sendErrorReports": true
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `summary` (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 = {
    "shops": [
        "planeo",
        "mobil-pohotovost"
    ],
    "searchQueries": [
        "iphone 17 256gb"
    ],
    "maxItems": 20,
    "maxItemsPerShop": 8,
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/czech-eshop-aggregator").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 = {
    "shops": [
        "planeo",
        "mobil-pohotovost",
    ],
    "searchQueries": ["iphone 17 256gb"],
    "maxItems": 20,
    "maxItemsPerShop": 8,
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/czech-eshop-aggregator").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 '{
  "shops": [
    "planeo",
    "mobil-pohotovost"
  ],
  "searchQueries": [
    "iphone 17 256gb"
  ],
  "maxItems": 20,
  "maxItemsPerShop": 8,
  "includeDetails": true
}' |
apify call tsutseisoftware/czech-eshop-aggregator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/czech-eshop-aggregator"
        }
    }
}
```

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/mTedouNOoeKm14sL2/builds/mHWYtvbFyiaaHtJWf/openapi.json
