# Prace.cz Scraper (`unfenced-group/prace-cz-scraper`) Actor Extract job listings from Prace.cz, the Czech Republic job board. Filter by location and employment type. - **URL**: https://apify.com/unfenced-group/prace-cz-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## Prace.cz Scraper Extract structured job listings from Prace.cz — the Czech Republic's largest job board with 25,000+ active vacancies. No API key required. Filter by location and employment type. ![Prace.cz Scraper](https://i.imgur.com/PLACEHOLDER.png) --- ### Why this scraper? #### 🇨🇿 Czech Republic's leading job board Práce.cz is the Czech Republic's most visited job portal and the primary hiring platform for Czech employers across all sectors. It provides the broadest available Czech market coverage. #### 🏢 Czech employer depth — Prague and regional Covers Prague, Brno, Ostrava, and all Czech regional cities. Strong coverage of Czech industrial employers, multinationals operating in Czech Republic, and local SMEs. #### 📄 Three description formats Each result includes `description` (HTML), `descriptionText` (plain text), and `descriptionMarkdown`. #### 🔁 Cross-run deduplication 90-day TTL dedup. Set `skipReposts: true` for clean incremental feeds. --- ### Why use this scraper? - **Full Czech Republic coverage** — access the complete job market, from Prague to regional cities - **Location filtering** — target specific cities or regions (Praha, Brno, Ostrava, and more) - **Employment type filtering** — full-time, part-time, or temporary positions - **Salary data** — structured salary fields (min, max, period, currency) wherever published - **Category tagging** — job category data extracted from each listing - **Cross-run deduplication** — 90-day repost detection prevents duplicate records across runs - **robots.txt compliant** — only scrapes paths permitted under `User-agent: *` ### Input parameters | Parameter | Type | `descriptionHtml` | String | Full job description as raw HTML. `null` if not fetched. | | `descriptionText` | String | Plain-text version of the description, HTML tags removed. | | `descriptionMarkdown` | String | Markdown version of the job description. | |---|---|---|---| | `location` | String | City or region slug (e.g. `brno`, `praha`, `ostrava`) | *(all CZ)* | | `employmentType` | Enum | `all`, `plny-uvazek`, `zkraceny-uvazek`, `brigada` | `all` | | `maxResults` | Integer | Maximum listings to return | `200` | | `skipReposts` | Boolean | Skip jobs seen in previous runs | `false` | | `startUrls` | Array | Custom `/nabidky/` browse URLs | `[]` | #### Location slug examples Use the location name as it appears in Prace.cz browse URLs: | City | Slug | |---|---| | Prague | `praha` | | Brno | `brno` | | Ostrava | `ostrava` | | Plzeň | `plzen` | | Liberec | `liberec` | | Pardubice | `pardubice` | #### Employment type slugs | Type | Slug | |---|---| | Full-time | `plny-uvazek` | | Part-time | `zkraceny-uvazek` | | Temporary / casual | `brigada` | ### Output fields Each result contains: ```json { "id": "2001121863", "url": "https://www.prace.cz/nabidka/2001121863/", "title": "Prodejce designových šperků MOOYYY v Praze", "location": "Praha", "company": "MOOYYY s. r. o.", "employmentTypes": ["Plný úvazek"], "salaryMin": 35000, "salaryMax": 37000, "salaryPeriod": "MONTH", "currency": "CZK", "salaryRaw": "35 000 – 37 000 Kč/měsíc", "category": "JD/Obchod a marketing/Obchodní zástupce", "listingVariant": "CP", "tags": ["Nutně vás potřebují"], "publishDate": null, "publishDateISO": null, "description": null, "descriptionText": null, "descriptionMarkdown": null, "contentHash": "a1b2c3d4e5f6g7h8", "summary": "Prodejce designových šperků MOOYYY v Praze | MOOYYY s. r. o. | Praha", "source": "prace.cz", "scrapedAt": "2026-04-08T12:00:00.000Z", "isRepost": false, "originalPublishDate": null, "originalUrl": null } ```` #### Field notes - **`description` / `descriptionText` / `descriptionMarkdown`**: Always `null`. Prace.cz detail pages redirect to employer-branded sites outside the allowed scope of this scraper. - **`publishDate` / `publishDateISO`**: Not available from list pages. Prace.cz does not expose publish dates in search results HTML. - **`salaryMin` / `salaryMax`**: `null` when salary is not published (approximately 40% of listings). - **`category`**: Internal Prace.cz job category path (e.g. `JD/IT-Vývoj software/Programátor`). ### Pricing **$1.49 per 1,000 results** — usage-based. You only pay for what you extract. | Volume | Cost | |---|---| | 1,000 results | ~$1.49 | | 10,000 results | ~$14.90 | | 100,000 results | ~$149.00 | Competing solutions charge flat monthly rates of $50–$500/month regardless of usage. This actor charges only for what you use. ### Performance | Metric | Value | |---|---| | Results per run | Up to 50,000 | | Speed | ~40 listings per page, ~1.5s between pages | | Memory | 256 MB | | Proxy required | No | ### Known limitations - **No keyword search** — Prace.cz's keyword search endpoint (`/hledat/`) is disallowed in their `robots.txt`. Use `location` and `employmentType` filters, or supply a custom `/nabidky/` browse URL via `startUrls`. - **No job description** — detail pages redirect to external employer career sites (outside scraper scope). - **No publish dates** — not exposed in Prace.cz search results HTML. - **Czech language** — all content (titles, locations, categories) is in Czech. ### Technical details - Architecture: HTTP-only with server-side rendered HTML parsing - Memory: 256 MB - Concurrency: 5 parallel pages maximum - Deduplication: 90-day TTL key-value store - Rate limiting: Gaussian-distributed inter-request delay (~1.5s mean) - Compliance: robots.txt checked on every run ### Additional services Need a custom integration, higher volumes, or scraping across multiple Czech/Slovak job boards? Contact us at **info@unfencedgroup.nl** — we offer tailored data pipelines and scheduled delivery. *** *unfenced-group · Apify portfolio · prace-cz-scraper v0.0* # Actor input Schema ## `location` (type: `string`): City or region slug as it appears in Prace.cz URLs (e.g. 'brno', 'praha', 'ostrava'). Leave empty to scrape all of Czech Republic. ## `employmentType` (type: `string`): Filter by employment type. ## `maxResults` (type: `integer`): Maximum number of job listings to return. ## `skipReposts` (type: `boolean`): Skip jobs already seen in previous runs (uses 90-day cross-run deduplication). ## `startUrls` (type: `array`): Optional list of Prace.cz /nabidky/ browse URLs to scrape directly. Overrides location and employmentType inputs. ## Actor input object example ```json { "location": "brno", "employmentType": "all", "maxResults": 200, "skipReposts": false, "startUrls": [] } ``` # Actor output Schema ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "brno" }; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/prace-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "brno" } # Run the Actor and wait for it to finish run = client.actor("unfenced-group/prace-cz-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 '{ "location": "brno" }' | apify call unfenced-group/prace-cz-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/prace-cz-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Prace.cz Scraper", "description": "Extract job listings from Prace.cz, the Czech Republic job board. Filter by location and employment type.", "version": "0.0", "x-build-id": "Hnj33ZkgzI5Bikvac" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~prace-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-prace-cz-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/unfenced-group~prace-cz-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-prace-cz-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/unfenced-group~prace-cz-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-prace-cz-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": { "location": { "title": "Location", "type": "string", "description": "City or region slug as it appears in Prace.cz URLs (e.g. 'brno', 'praha', 'ostrava'). Leave empty to scrape all of Czech Republic.", "default": "" }, "employmentType": { "title": "Employment type", "enum": [ "all", "plny-uvazek", "zkraceny-uvazek" ], "type": "string", "description": "Filter by employment type.", "default": "all" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of job listings to return.", "default": 200 }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Skip jobs already seen in previous runs (uses 90-day cross-run deduplication).", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of Prace.cz /nabidky/ browse URLs to scrape directly. Overrides location and employmentType inputs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```