` whose fields live in
sibling elements, so blocks are cut at the next block rather than at a closing
tag.
Pagination is a **path offset** (`/40/`), verified by set overlap rather than
by comparing first rows: `/20/`, `/40/` and `/2000/` each share zero ids with
page 1.
One detail worth stating because it looks like a trap and is not: each page
carries 20 listing blocks but **21** price cells. The extra one is the
`Cena`/`Lokalita` table header, not a hidden promoted row. Block-based
extraction excludes it by construction, and the Actor asserts that this is
still the reason — so if a real 21st row ever appears, the run fails loudly
instead of quietly emitting a header as a listing.
# Actor input Schema
## `categories` (type: `array`):
Bazos categories to scrape. Use a plain name (auto, reality, zvirata...), a subdomain host (auto.bazos.cz), or paste a category or SUBCATEGORY URL from the site (https://auto.bazos.cz/audi/). URLs with a query string are refused: every Bazos robots.txt disallows the hledat= / order= / cenaod= search surface, so this Actor navigates by path only.
## `maxPages` (type: `integer`):
Pages of 20 listings to fetch per category. Bazos serves at most 20000 rows (1000 pages) per category before answering 404, however many it claims to hold.
## `maxItems` (type: `integer`):
Stop after this many listing rows in total. Leave empty for no limit.
## `promotedOnly` (type: `boolean`):
Keep only ads with a paid TOP bump. Useful for measuring dealer advertising spend.
## `skipPromoted` (type: `boolean`):
Drop ads with a paid TOP bump. Note the first ~9000 rows of a busy category are ALL promoted, so this may return very little unless you also raise Max pages.
## `maxConcurrency` (type: `integer`):
Parallel requests. Kept low by default; Bazos is a small site.
## `minRequestInterval` (type: `number`):
Politeness floor between request starts.
## `proxy` (type: `object`):
Apify Proxy settings. Residential is recommended for large runs.
## Actor input object example
```json
{
"categories": [
"auto"
],
"maxPages": 5,
"promotedOnly": false,
"skipPromoted": false,
"maxConcurrency": 2,
"minRequestInterval": 1,
"proxy": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `items` (type: `string`):
One row per scraped record. See the dataset's default view for field definitions.
# 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 '
' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"categories": [
"auto"
],
"maxPages": 5
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapyx/bazos-classifieds-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"categories": ["auto"],
"maxPages": 5,
}
# Run the Actor and wait for it to finish
run = client.actor("scrapyx/bazos-classifieds-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 '{
"categories": [
"auto"
],
"maxPages": 5
}' |
apify call scrapyx/bazos-classifieds-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapyx/bazos-classifieds-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 ` 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/hwR4WzWwdZGsfLWf6/builds/HueTCARciamVetbnB/openapi.json