# Sauto.cz Scraper — Czech Used Car Listings & Prices (`rastriq/sauto-cz-scraper`) Actor

Scrape car listings from Sauto.cz, the largest Czech car marketplace. Get make, model, year, mileage, CZK price, fuel, gearbox, district, region, dealer or private seller, photo and URL. Cars only by default; no proxy needed.

- **URL**: https://apify.com/rastriq/sauto-cz-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 car listings

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

## 🚗 Sauto.cz Scraper — Czech Used Car Listings & Prices

Sauto.cz Scraper extracts car listings from [Sauto.cz](https://www.sauto.cz), the largest car marketplace in the Czech Republic, and gives you make, model, year, mileage, price in CZK, fuel, gearbox, district, region, seller type, photo and listing URL as clean JSON, CSV or Excel. It reads Sauto.cz's own search API, needs no browser and no proxy, and returns 20 listings per page in seconds.

### What is Sauto.cz Scraper?

Sauto.cz lists more than 100,000 passenger cars for sale, from private sellers and from dealers across all 14 Czech regions. Browsing it by hand is fine for one car; it does not work when you need to track prices for a whole model, monitor dealer stock or feed a valuation model.

Sauto.cz Scraper turns a Sauto.cz search into a dataset. Pick a category, optionally filter by brand, model, fuel, gearbox, year and price, choose how many pages you want, and run it. Each row is one listing with the same column names Rastriq uses across its European car scrapers, so you can merge Czech data with other markets without remapping.

By default the scraper searches **passenger cars only**. Sauto.cz's unfiltered search mixes cars with vans and motorhomes; you can still pick those categories, or all of them, in the input.

### 🎯 Who uses a Sauto.cz scraper?

- 📈 **Price analysts and valuation teams**: build a Czech used-car price index by make, model, year and mileage.
- 🏪 **Car dealers and importers**: watch competitors' stock and asking prices, or find cars to import.
- 🔍 **Car buyers and brokers**: export every listing that matches a search and sort it your own way.
- 🧪 **Data scientists**: get training data for price-prediction models, refreshed on a schedule.
- 🌍 **Cross-border price tracking**: compare Czech prices with Germany, Poland, Slovakia or Austria using the same schema.

### 📋 What data does Sauto.cz Scraper extract?

| Field | Description |
|---|---|
| 🆔 `id` | Sauto.cz listing id |
| 🏷️ `title` | Listing title: make, model and the seller's short headline |
| 🚘 `make` / `model` | Manufacturer and model, e.g. Škoda / Octavia |
| 📅 `year` | Year of manufacture |
| 🛣️ `km` | Odometer reading in kilometres |
| 💰 `price` / `currency` | Asking price, always in CZK |
| ⛽ `fuel_type` | gasoline, diesel, electric, lpg, cng or hybrid |
| ⚙️ `gearbox` | manual or automatic |
| 📍 `city` / `region` | District (okres) and region (kraj) where the car is offered |
| 🏢 `is_professional` | `true` for dealers, `false` for private sellers |
| 🔗 `url` | Link to the listing on sauto.cz |
| 🖼️ `img_url` | Main photo |
| 🕒 `scraped_at` | When the listing was collected (UTC) |

`hp` is a reserved column shared with other Rastriq scrapers; Sauto.cz search results do not include engine power, so it is always `null`. The scraper does not collect seller names, phone numbers or e-mail addresses.

### 🚀 How to use Sauto.cz Scraper

1. Open Sauto.cz Scraper in Apify Console and click **Try for free**.
2. Keep **Vehicle category** on *Cars*, or choose *Vans*, *Motorhomes* or *All categories*.
3. Optionally type a **Brand** (`skoda`, `bmw`, `mercedes-benz`) or brand and model (`skoda:octavia`), and set fuel, gearbox, year and price filters.
4. Set **Max pages**. Each page has 20 listings; the prefilled value of 1 page is a quick, cheap test.
5. Click **Start**. A one-page run finishes in about 5 seconds.
6. Download the results as JSON, CSV, Excel or HTML, or read them through the Apify API.

To keep a Czech price history, save the input as a task and add a schedule. Every run writes a fresh dataset.

### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `category` | string | `cars` | `cars`, `vans`, `motorhomes` or `all` |
| `brand` | string | — | Make in Sauto.cz URL form, optionally with a model: `skoda:octavia` |
| `fuel_type` | string | — | `gasoline`, `diesel`, `electric`, `lpg`, `cng`, `hybrid` |
| `gearbox` | string | — | `manual` or `automatic` |
| `min_year` / `max_year` | integer | — | Year of manufacture range |
| `min_price` / `max_price` | integer | — | Price range in CZK |
| `max_pages` | integer | `3` | Pages to fetch, 20 listings each |
| `proxyConfiguration` | object | none | Optional Apify Proxy settings |

Example input, diesel Škoda Octavias from 2018 or newer under 400,000 CZK:

```json
{
  "category": "cars",
  "brand": "skoda:octavia",
  "fuel_type": "diesel",
  "min_year": 2018,
  "max_price": 400000,
  "max_pages": 5
}
```

### 📦 Output example

One listing from a real run (15 November 2026):

```json
{
  "id": "211384398",
  "title": "Škoda Kodiaq, Sportline 1.5 TSi DSG ,Virtual",
  "make": "Škoda",
  "model": "Kodiaq",
  "year": 2023,
  "km": 145103,
  "hp": null,
  "price": 579000,
  "currency": "CZK",
  "fuel_type": "gasoline",
  "gearbox": "automatic",
  "city": "Teplice",
  "region": "Ústecký kraj",
  "is_professional": false,
  "url": "https://www.sauto.cz/osobni/detail/skoda/kodiaq/211384398",
  "img_url": "https://d19-a.sdn.cz/d_19/c_img_qH_A/kb4JgeTdkDyuEmIqVtIQbfx4/9c8d.jpeg",
  "source": "sauto.cz",
  "scraped_at": "2026-11-15T10:56:14.581641+00:00"
}
```

In Apify Console the **Overview** tab shows photo, title, make, model, year, mileage, price, fuel, gearbox, district, seller type and link; **Location and seller** adds the region.

### 💰 How much does it cost to scrape Sauto.cz?

Sauto.cz Scraper uses **pay-per-event** pricing. You pay for results, with no monthly rental:

- **$0.90 per 1,000 listings** saved to the dataset ($0.0009 per listing);
- **$0.005 per run start** (one start event per GB of memory; the default 256 MB counts as one).

Platform usage is included in these prices. Some examples:

| Listings | Approximate cost |
|---|---|
| 20 (1 page) | $0.023 |
| 1,000 (50 pages) | $0.91 |
| 10,000 (several runs) | about $9 |

With the $5 of free monthly credit on the Apify Free plan you can scrape about 5,000 Sauto.cz listings a month. Use **Max pages** to cap what a run can cost.

### ⚠️ Limits

- **Search results only.** The scraper reads the search API, not each detail page. Description, equipment, engine power, colour, VIN and seller contact details are not extracted.
- **Filters need a category.** Sauto.cz ignores the brand, fuel and gearbox filters when no category is selected, so with *All categories* those three filters have no effect (the log warns you). Year and price filters work everywhere.
- **Czech labels for rare values.** Fuels and gearboxes outside the list above (ethanol, hydrogen, semi-automatic...) are returned in lower-case Czech, as Sauto.cz publishes them.
- **Price can be 0 or null** when the seller asks for offers instead of giving a price.

### 🔗 Related Actors

- [AutoScout24 Scraper](https://apify.com/rastriq/autoscout24-scraper): 8 European countries
- [Willhaben Scraper](https://apify.com/rastriq/willhaben-scraper): Austria's car marketplace
- [Mobile.de Scraper](https://apify.com/rastriq/mobile-de-scraper): Germany
- [OtoMoto Scraper](https://apify.com/rastriq/otomoto-scraper): Poland

### ❓ FAQ

**Is it legal to scrape Sauto.cz?**
Sauto.cz Scraper only collects publicly visible listing data and no seller names or contact details. However, Sauto.cz's robots.txt disallows generic crawlers, and the site's terms may restrict automated collection and reuse. You are responsible for how you use the data: check Sauto.cz's terms, get advice before commercial reuse, and do not use the data to contact sellers in bulk.

**Do I need a proxy?**
No. Our test runs used no proxy. If you start seeing HTTP 403 or 429 in the log, add Apify Proxy in the **Advanced** section.

**Why did earlier runs include motorhomes and vans?**
Sauto.cz's unfiltered search mixes all vehicle categories. Since version 0.2 Sauto.cz Scraper searches passenger cars unless you choose another category.

**How do I filter by model?**
Put the brand and model in **Brand**, separated by a colon, using the names from Sauto.cz URLs: `volkswagen:golf`, `skoda:superb`, `bmw:x5`.

**How many listings can I get?**
Each page has 20 listings. Raise **Max pages** for bigger exports, or split by brand or price band and merge the datasets.

**Can I schedule Sauto.cz Scraper?**
Yes. Save your input as a task and add a schedule in Apify Console, then compare each dataset with the previous one.

**Something broke. What do I do?**
Open an issue on the Actor's **Issues** tab with the run link and we will look into it.

# Changelog

This Actor's version history is a separate document: https://apify.com/rastriq/sauto-cz-scraper/changelog.md

# Actor input Schema

## `category` (type: `string`):

Which Sauto.cz section to search. <b>Cars</b> (passenger cars) is the default. Without a category, Sauto.cz mixes cars, vans and motorhomes in one list and ignores the brand, fuel and gearbox filters; choose <b>All categories</b> only if you want that mix.

## `brand` (type: `string`):

Optional. Make as it appears in Sauto.cz URLs, in lower case: <code>skoda</code>, <code>volkswagen</code>, <code>bmw</code>, <code>mercedes-benz</code>. Add a model after a colon to narrow further: <code>skoda:octavia</code>.

## `fuel_type` (type: `string`):

Optional fuel filter.

## `gearbox` (type: `string`):

Optional gearbox filter.

## `min_year` (type: `integer`):

Optional. Oldest year of manufacture to include, e.g. 2018.

## `max_year` (type: `integer`):

Optional. Newest year of manufacture to include.

## `min_price` (type: `integer`):

Optional. Lowest asking price in Czech koruna.

## `max_price` (type: `integer`):

Optional. Highest asking price in Czech koruna.

## `max_pages` (type: `integer`):

How many result pages to fetch. Each page holds 20 listings, so 3 pages = up to 60 listings. Raise it for bigger exports.

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

Optional. Sauto.cz works without a proxy; tested runs used none. Add Apify Proxy only if you see HTTP 403 or 429 errors in the log.

## Actor input object example

```json
{
  "category": "cars",
  "max_pages": 1
}
```

# Actor output Schema

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

All scraped listings in the default dataset.

# 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 = {
    "category": "cars",
    "max_pages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/sauto-cz-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 = {
    "category": "cars",
    "max_pages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/sauto-cz-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 '{
  "category": "cars",
  "max_pages": 1
}' |
apify call rastriq/sauto-cz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/sauto-cz-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/LyYwrbcS56j8oWHR1/builds/fNVJtrYFlxPwaZdwM/openapi.json
