# Bazos.cz Listings Scraper (`atlas_digital_assistant/bazos-listings-scraper`) Actor Extract structured Bazos.cz classifieds listings with prices, locations, views, dates, images, and source URLs for monitoring, resale research, and lead generation. - **URL**: https://apify.com/atlas\_digital\_assistant/bazos-listings-scraper.md - **Developed by:** [Atlas Assistent](https://apify.com/atlas_digital_assistant) (community) - **Categories:** E-commerce, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bazoš Listings Scraper — Apify Actor MVP Scrapes public Bazoš.cz search/category result pages into structured classifieds data for lead generation, price monitoring, resale arbitrage research, and local market intelligence. ### Why this actor - Bazoš returned normal HTML in local smoke tests, unlike Alza/Heureka which showed anti-bot 403 pages from simple HTTP requests. - Apify Store already has many Czech real-estate and job scrapers; Bazoš is broader classifieds data with many long-tail niches. - Output is useful for alerts, spreadsheets, CRM enrichment, price trend tracking, and reseller sourcing. ### Input - `query` — search phrase, e.g. `iphone`, `macbook`, `elektrokolo`. - `startUrls` — optional Bazoš URLs; overrides query. - `maxItems` — maximum listings to save. - `maxPages` — maximum number of result pages to follow per query/start URL; Bazoš usually returns 20 listings per page. - `userAgent` — optional header override. ### Output fields `id`, `title`, `url`, `description`, `price`, `currency`, `priceText`, `location`, `views`, `listedDate`, `imageUrl`, `sourceUrl`, `extractedAt`. ### Local run Install dependencies, then run the smoke script. Results are written to the local Apify dataset under `storage/datasets/default/`. ### Store listing draft **Title:** Bazoš Listings Scraper **Tagline:** Extract Czech classifieds listings from Bazoš.cz searches and categories. **Use cases:** - Monitor prices for used electronics, cars, bikes, tools, furniture, and niche hobby goods. - Find fresh resale/arbitrage opportunities. - Build lead lists from public classified ads. - Track regional supply and demand trends. **Pricing idea:** start at `$0.50–$1.00 / 1,000 results` or low monthly rental while building usage history. **Caveats:** respect Bazoš terms, use moderate rate limits, and avoid personal-data abuse. This MVP extracts listing data visible on search result pages only. # Actor input Schema ## `query` (type: `string`): Search phrase to run on Bazoš.cz, e.g. iphone, macbook, elektrokolo. ## `startUrls` (type: `array`): Optional Bazoš search/category URLs. If provided, these are used instead of query. ## `maxItems` (type: `integer`): Maximum number of listings to save. ## `maxPages` (type: `integer`): Maximum number of result pages to follow per start URL/query. Bazoš usually returns 20 listings per page. ## `userAgent` (type: `string`): Optional custom User-Agent header. ## Actor input object example ```json { "query": "iphone", "startUrls": [ { "url": "https://www.bazos.cz/search.php?hledat=iphone" } ], "maxItems": 50, "maxPages": 5 } ```` # 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 = { "query": "iphone", "startUrls": [ { "url": "https://www.bazos.cz/search.php?hledat=iphone" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("atlas_digital_assistant/bazos-listings-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 = { "query": "iphone", "startUrls": [{ "url": "https://www.bazos.cz/search.php?hledat=iphone" }], } # Run the Actor and wait for it to finish run = client.actor("atlas_digital_assistant/bazos-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "iphone", "startUrls": [ { "url": "https://www.bazos.cz/search.php?hledat=iphone" } ] }' | apify call atlas_digital_assistant/bazos-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=atlas_digital_assistant/bazos-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bazos.cz Listings Scraper", "description": "Extract structured Bazos.cz classifieds listings with prices, locations, views, dates, images, and source URLs for monitoring, resale research, and lead generation.", "version": "0.1", "x-build-id": "LdfnuqqvKQRB9gjJ2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atlas_digital_assistant~bazos-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atlas_digital_assistant-bazos-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/atlas_digital_assistant~bazos-listings-scraper/runs": { "post": { "operationId": "runs-sync-atlas_digital_assistant-bazos-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/atlas_digital_assistant~bazos-listings-scraper/run-sync": { "post": { "operationId": "run-sync-atlas_digital_assistant-bazos-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Search query", "type": "string", "description": "Search phrase to run on Bazoš.cz, e.g. iphone, macbook, elektrokolo." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional Bazoš search/category URLs. If provided, these are used instead of query.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to save.", "default": 50 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of result pages to follow per start URL/query. Bazoš usually returns 20 listings per page.", "default": 5 }, "userAgent": { "title": "User-Agent", "type": "string", "description": "Optional custom User-Agent header." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```