# Bazos.cz Scraper — Czech Classifieds, Property & Prices (`logiover/bazos-cz-scraper`) Actor

Scrape job postings for Austria from Talent.com: title, hiring company, city, quick-apply flag, update recency and a description snippet. Keyless, no login. Export JSON, CSV or Excel.

- **URL**: https://apify.com/logiover/bazos-cz-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 results

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

## Bazos.cz Scraper — Czech Classifieds, Property & Prices

![Apify Actor](https://img.shields.io/badge/Apify-Actor-00A67E?logo=apify\&logoColor=white) ![No API key](https://img.shields.io/badge/No%20API%20key-required-2ea44f) ![Pay per result](https://img.shields.io/badge/Pricing-Pay%20per%20result-1C7ED6) ![Export](https://img.shields.io/badge/Export-JSON%20%7C%20CSV%20%7C%20Excel-F59E0B)

**Scrape job postings for Austria from Talent.com: title, hiring company, city, quick-apply flag, update recency and a description snippet. Keyless, no login. Export JSON, CSV or Excel.**

***

### What does the Bazos.cz Scraper do?

This Actor turns Bazos.cz into a structured dataset you can actually work with. You give it a search, it walks the result pages, and it writes one clean row per record into your dataset — ready to export as JSON, CSV or Excel, or to pull straight from the Apify API.

It runs on plain HTTP with no browser and no login, which keeps it fast and cheap, and it works the same on a free account as on a paid one. Every field documented below came from a real verification run of this Actor, so what you read here is what you get.

The current build returns **16 populated fields** per record, of which **16 are present on virtually every row**.

### Who is it for?

- **Analysts** who need Bazos.cz data as a spreadsheet instead of a browser tab.
- **Operations and research teams** tracking how Bazos.cz listings change over time.
- **Developers** wiring a live data feed into an internal tool or database.
- **Growth and sales teams** building prospect and market lists from public data.
- **AI teams** assembling structured training or grounding data.

### Use cases

- Export a full Bazos.cz search into a spreadsheet for analysis.
- Track how prices, volumes or availability move week over week by scheduling the run.
- Feed a dashboard or internal database with a repeatable, structured source.
- Build a market map by running several searches in one job.
- Enrich an existing list by matching on the identifiers in the output.

### Why use this Bazos.cz Scraper?

- 🔑 **No API key and no login** — nothing to authenticate, nothing to expire.
- 📦 **16 verified fields** — every column below was confirmed against live output.
- 📄 **Real pagination** — it walks the result set instead of returning the first screen.
- 🎯 **Bounded runs** — caps in the input stop the job exactly where you want, so the bill is predictable.
- 💸 **Tiered pay-per-result** — you pay per row, and higher Apify plans pay less per row.
- 📊 **Export anywhere** — JSON, CSV, Excel, HTML, the API, or any Apify integration.

### What data can you extract?

One row per record. These columns come from a live run, with the share of rows that carried a value:

| Field | Type | Typically filled | Description |
|-------|------|------------------|-------------|
| `country` | number | 100% | Country |
| `currency` | string | 95% | Currency |
| `description` | string | 100% | Description |
| `imageUrl` | string | 100% | Image url |
| `isTop` | boolean | 100% | Is top |
| `listingId` | string | 100% | Listing id |
| `listingUrl` | string | 100% | Listing url |
| `postcode` | string | 100% | Postcode |
| `postedLabel` | string | 100% | Posted label |
| `priceAmount` | number | 95% | Price amount |
| `priceLabel` | number | 100% | Price label |
| `scrapedAt` | string | 100% | Scraped at |
| `source` | string | 100% | Source |
| `title` | string | 100% | Title |
| `town` | string | 100% | Town |
| `views` | number | 100% | Views |

#### Output example

```json
{
  "country": "Czechia",
  "currency": "CZK",
  "description": "Ahoj, prodávám družstevní byt v Jevanské ulici na Praze 10. Nechci z toho dělat klasický realitní román, takže stručně: • 2+1 o ploše 68,29 m² • dva velké a neprůchozí pokoje • dřevěné parkety v obou pokojích • samostatná kuchyně • prostorná v ...",
  "imageUrl": "https://www.bazos.cz/img/1t/268/223324268.jpg?t=1788363778",
  "isTop": true,
  "listingId": "223324268",
  "listingUrl": "https://www.bazos.cz/inzerat/223324268/byt-21-praha-strasnice-68-m-5-min-metro-skalka.php",
  "postcode": "100 00",
  "postedLabel": "11.9. 2026",
  "priceAmount": 7890000,
  "priceLabel": "7 890 000 Kč",
  "scrapedAt": "2026-09-11T09:30:47.214Z",
  "source": "bazos_cz",
  "title": "BYT 2+1, Praha, Strašnice – 68 m², 5 min metro Skalka",
  "town": "Praha 10",
  "views": 3323
}
```

### How to use

1. Open the Actor and fill in the search fields — the defaults below are a working example.
2. Set the result cap so the run stops where you want it.
3. Click **Start**, then export from the **Output** tab or pull the dataset through the API.

```json
{
  "section": "reality",
  "categoryPath": "prodam/byt",
  "minPrice": 0,
  "maxPrice": 0,
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}
```

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `section` | string | `reality` | Bazos subdomain to scrape — each section is its own site. |
| `categoryPath` | string | `–` | Path inside the section, e.g. |
| `query` | string | `–` | Optional free-text filter inside the category. |
| `minPrice` | integer | `0` | Only return listings at or above this price. |
| `maxPrice` | integer | `0` | Only return listings at or below this price. |
| `maxResults` | integer | `500` | Stop after this many listings. |
| `proxyConfiguration` | object | `{"useApifyProxy": true, "a` | Bazos blocks datacenter traffic, so residential Czech proxy is required and is preselected. |

### Tips for best results

- Broad searches return the deepest result sets; very narrow ones run out after a page or two.
- Use the result cap rather than the page cap when you want a predictable bill.
- Schedule the same input daily or weekly to build a history instead of a one-off snapshot.
- Lower the concurrency if you see retries — the source rate-limits aggressive crawling.
- Run several searches in one job instead of one search with a huge page count.
- Empty optional fields are normal; filter on the columns that matter to you after export.
- Deduplicate on the identifier column if you merge several runs together.
- Keep the proxy setting on the default unless the source blocks your region.

### Integrations

Push results straight into **Google Sheets**, **Slack**, **Zapier**, **Make**, **Airtable** or any **Webhook**. You can also **schedule** the Actor and have each run append to the same dataset, which is how you turn a single export into a time series.

### API usage

Replace `<YOUR_TOKEN>` with your Apify API token.

**cURL**

```bash
curl -X POST "https://api.apify.com/v2/acts/logiover~bazos-cz-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"section": "reality", "categoryPath": "prodam/byt", "minPrice": 0, "maxPrice": 0, "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CZ"}}'
```

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient('<YOUR_TOKEN>')
run = client.actor('logiover/bazos-cz-scraper').call(run_input={"section": "reality", "categoryPath": "prodam/byt", "minPrice": 0, "maxPrice": 0, "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CZ"}})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

**Node.js**

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

const client = new ApifyClient({ token: '<YOUR_TOKEN>' });
const run = await client.actor('logiover/bazos-cz-scraper').call({"section": "reality", "categoryPath": "prodam/byt", "minPrice": 0, "maxPrice": 0, "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CZ"}});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Use with AI agents (MCP)

This Actor is reachable through the Apify MCP server, so an AI agent can call it as a tool. Point the agent at `https://mcp.apify.com` and ask it something like *"pull the first 200 jobs from Bazos.cz and summarise them"* — it receives the same structured rows you would get from the UI.

### FAQ

#### Do I need a Bazos.cz account or API key?

No. The Actor reads publicly available pages only. There is nothing to authenticate and no credentials to rotate.

#### Does it work on the free plan?

Yes. Every feature is available on a free Apify account — nothing is gated behind a paid tier. Pricing is per result, and higher plans simply pay less per row.

#### How many jobs can I get in one run?

As many as the search exposes. Raise the page and result caps together; the run stops at whichever limit it reaches first.

#### Why did I get fewer rows than I asked for?

The search ran out of records. That is normal for narrow queries — broaden the search or add more searches to one run.

#### Why are some fields empty?

Bazos.cz does not publish every attribute for every record. The table above shows how often each field is filled in practice.

#### What export formats are supported?

JSON, CSV, Excel, HTML and RSS from the Output tab, plus the Apify API and any integration you connect.

#### How fast is it?

It is pure HTTP with no browser, so a page of results typically takes a second or two.

#### Can I schedule it?

Yes. Use the Apify scheduler to run it on any interval and append each run to the same dataset.

#### Does it use a proxy?

It routes through Apify Proxy by default. You can switch groups or supply your own proxies in the input.

#### Is the output schema stable?

Yes. Field names and types are fixed, so downstream pipelines will not break between runs.

#### How often is the data refreshed?

Every run reads the live source. There is no cache, so the data is as current as the website itself.

#### What if the site changes its layout?

Open an issue on the Issues tab and it gets fixed — the Actor is actively maintained.

### Is it legal?

This Actor reads only publicly available pages on Bazos.cz — the same content any visitor sees without logging in. It does not bypass authentication and does not collect private data. You remain responsible for how you use the output: respect the source's terms of service, applicable copyright, and data-protection law such as GDPR where personal data is involved.

### Related scrapers

Browse the full collection at [apify.com/logiover](https://apify.com/logiover) — Jobs, Lead Generation tools and more.

***

### Related scrapers

Other Actors from the same collection:

- [Bazos.cz](https://apify.com/logiover/bazos-cz-classifieds-scraper)
- [SS.lv](https://apify.com/logiover/ss-lv-scraper)
- [reality.idnes.cz](https://apify.com/logiover/reality-idnes-cz-scraper)
- [DOM.RIA](https://apify.com/logiover/dom-ria-scraper)

### How much Bazos.cz data can you extract in one run?

A single run returned **1,000 listings** in 91 seconds on the example input, and it was still going when the measurement stopped — raise the result limit and it keeps paginating. That is roughly **659 listings a minute**.

There is no hard ceiling built into this Actor. What bounds a run is the result limit you set, the breadth of the input you give it, and how much Bazos.cz itself publishes. Because billing is per result, a wider run costs proportionally more and a narrow one costs almost nothing — so it is worth starting small and scaling once the output looks right.

# Changelog

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

# Actor input Schema

## `section` (type: `string`):

Bazos subdomain to scrape — each section is its own site.

## `categoryPath` (type: `string`):

Path inside the section, e.g. "prodam/byt" (flats for sale), "pronajmu/byt" (flats to rent), "prodam/dum" (houses).

## `query` (type: `string`):

Optional free-text filter inside the category.

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

Only return listings at or above this price. 0 disables the filter.

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

Only return listings at or below this price. 0 disables the filter.

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

Stop after this many listings. Bazos pages in steps of 20 and the Actor walks until the target is met.

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

Bazos blocks datacenter traffic, so residential Czech proxy is required and is preselected. Changing it away from residential will return no results.

## Actor input object example

```json
{
  "section": "reality",
  "categoryPath": "prodam/byt",
  "minPrice": 0,
  "maxPrice": 0,
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}
```

# Actor output Schema

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

All records from this run.

# 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 = {
    "section": "reality",
    "categoryPath": "prodam/byt",
    "query": "",
    "minPrice": 0,
    "maxPrice": 0,
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CZ"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/bazos-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 = {
    "section": "reality",
    "categoryPath": "prodam/byt",
    "query": "",
    "minPrice": 0,
    "maxPrice": 0,
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CZ",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/bazos-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 '{
  "section": "reality",
  "categoryPath": "prodam/byt",
  "query": "",
  "minPrice": 0,
  "maxPrice": 0,
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}' |
apify call logiover/bazos-cz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/bazos-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/u2GYJgaYcoX5iZiM9/builds/zEjmlg0wnLrrcMf2z/openapi.json
