# Posao.hr Scraper (`unfenced-group/posao-hr-scraper`) Actor Extract structured job data from Posao.hr Keyword, county, category filters. Salary, job type, qualifications. No API key required. - **URL**: https://apify.com/unfenced-group/posao-hr-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.49 / 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 ## Posao.hr Scraper ![Posao.hr Scraper Banner](https://i.imgur.com/1CY52qE.png) Extract structured job listings from [posao.hr](https://www.posao.hr) — Croatia's leading job board with over 7,600 active vacancies. No account or API key required. Supports keyword search, county and category filtering, and full job detail extraction including salary, contract type, qualifications, and application links. --- ### Why this scraper? #### 🇭🇷 Full Croatian market coverage Access all 7,600+ active job listings across every Croatian county and 26 job categories — from Zagreb to Split to Abroad. #### 💰 Salary data extracted When employers disclose compensation, the scraper captures both the minimum and maximum net salary in EUR, including whether it is a net or gross figure. #### 📋 Rich structured output Each result includes job type (permanent/fixed-term), required qualifications, work experience, language skills, company address, and benefits — fields not available on most Croatian job boards. #### 🔄 Cross-run repost detection The built-in 90-day deduplication engine tracks every job ID across runs. Enable **Skip reposts** to only retrieve genuinely new listings. #### 🎯 Flexible filtering Filter by keyword, county (21 Croatian regions + Abroad), job category, publication date, and whether a salary is disclosed — individually or in combination. #### ⚡ Fast listing mode Disable **Fetch detail pages** to collect URLs, titles, and locations at high speed when you only need a quick inventory. --- ### Input parameters | Parameter | Type | Default | `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. | |---|---|---|---| | `searchQuery` | String | `""` | Keyword(s) to search for. Leave empty to browse all jobs. | | `location` | Select | All regions | Filter by Croatian county. | | `category` | Select | All categories | Filter by job category. | | `daysOld` | Integer | — | Only return jobs published within this many days. | | `salaryOnly` | Boolean | `false` | Restrict to jobs with a disclosed salary. | | `fetchDetails` | Boolean | `true` | Fetch full job detail pages. Disable for fast, sparse output. | | `skipReposts` | Boolean | `false` | Skip jobs already seen in previous runs. | | `maxResults` | Integer | `100` | Maximum number of results. | | `startUrls` | Array | `[]` | Specific posao.hr job URLs to scrape directly. | --- ### Output schema Each result contains the following fields. **Always present:** | Field | Type | Description | |---|---|---| | `id` | string | Unique job listing ID from the source platform. | | `url` | string | Direct URL to the job listing. | | `title` | string | Job title as published. | | `company` | string | Employer / company name. | | `location` | string | Full location as published (city, region, or country). | | `region` | string | Region or province. | | `categories` | array | Job categories or industry sectors. | | `deadline` | string | deadline field. | | `deadlineRaw` | string | deadlineRaw field. | | `daysLeft` | integer | daysLeft field. | | `salary` | string | Raw salary string as shown on the site (null if not published). | | `salaryMin` | number | Minimum salary (null if not published by employer). | | `salaryMax` | number | Maximum salary (null if not published by employer). | | `salaryNet` | boolean | salaryNet field. | | `currency` | string | currency field. | | `jobType` | string | Type of employment (Full-time, Part-time, Contract, etc.). | | `qualifications` | string | qualifications field. | | `requiredExperience` | string | requiredExperience field. | | `foreignLanguage` | string | foreignLanguage field. | | `computerSkills` | string | computerSkills field. | | `applyUrl` | string | Direct application URL (null if not available). | | `companyAddress` | string | companyAddress field. | | `companyWebsite` | string | Company external website URL. | | `publishDate` | string | Publication date (YYYY-MM-DD). | | `publishDateISO` | string | Publication date in ISO 8601 format. | | `source` | string | Source domain name (e.g. 'pracuj.pl'). | | `scrapedAt` | string | ISO 8601 timestamp of when this item was scraped. | | `contentHash` | string | MD5 hash of key fields for change detection (16 chars). | | `summary` | string | Human-readable one-line summary of the listing. | | `isRepost` | boolean | True if this listing was seen in a previous run (90-day window). | | `originalPublishDate` | string | Original publish date if this is a repost (null otherwise). | | `originalUrl` | string | Original URL if this is a repost (null otherwise). | **With `fetchDetails: true` (default):** | Field | Type | Description | |---|---|---| | `description` | string | Full job description as raw HTML (null if fetchDetails is false). | | `descriptionText` | string | Full job description as plain text (null if fetchDetails is false). | | `descriptionMarkdown` | string | Full job description in Markdown format (null if fetchDetails is false). | | `benefits` | array | Employee benefits listed by the employer. | | `requirements` | string | requirements field. | **Example output record:** ```json { "id": "1202290", "url": "https://www.posao.hr/oglasi/prodajni-agent-u-call-centru-m-z/1202290/", "title": "Prodajni agent u call centru (m/ž)", "company": "CompanyWall d.o.o.", "location": "Zagreb, Osijek", "region": "City of Zagreb, County of Zagreb region", "categories": ["Computer science, IT & telecommunication", "Sale (Wholesale - Retail)"], "deadline": "2026-04-14", "deadlineRaw": "14.04.2026.", "daysLeft": 5, "salary": "from 1 176 € to 2 000 € net", "salaryMin": 1176, "salaryMax": 2000, "salaryNet": true, "currency": "EUR", "jobType": "permanent employment", "qualifications": "High school", "requiredExperience": "one year", "foreignLanguage": "english", "computerSkills": "good", "description": "", "descriptionText": "Savjetovanje klijenata...", "descriptionMarkdown": "- Savjetovanje klijenata...", "benefits": "", "requirements": "", "applyUrl": "https://www.posao.hr/prijava/companywall-d-o-o-prodajni-agent-u-call-centru-m-z/102199", "companyAddress": "Ilica 1, 10000 Zagreb", "companyWebsite": "companywall.hr", "publishDate": null, "publishDateISO": null, "source": "posao.hr", "scrapedAt": "2026-04-09T12:00:00.000Z", "contentHash": "a3f1b2c4d5e6f789", "summary": "Prodajni agent u call centru (m/ž) — CompanyWall d.o.o. — Zagreb, Osijek", "isRepost": false, "originalPublishDate": null, "originalUrl": null } ```` *** ### Examples **Example 1 — Browse all IT jobs in Zagreb** ```json { "category": "9", "location": "00", "maxResults": 50 } ``` **Example 2 — Recent hospitality jobs with salary, last 7 days** ```json { "category": "29", "daysOld": 7, "salaryOnly": true, "maxResults": 200 } ``` **Example 3 — Keyword search across all Croatia, skip already-seen jobs** ```json { "searchQuery": "vozač", "skipReposts": true, "maxResults": 500 } ``` **Example 4 — Scrape specific job URLs directly** ```json { "startUrls": [ { "url": "https://www.posao.hr/oglasi/naziv-posla/1234567/" }, { "url": "https://www.posao.hr/oglasi/drugi-posao/7654321/" } ] } ``` **Example 5 — Full export: all active jobs, no filters** ```json { "maxResults": 10000 } ``` *** ### 💰 Pricing **$1.49 per 1,000 results** — you only pay for successfully retrieved listings. Failed retries and filtered reposts are never charged. | Results | Cost | |---------|------| | 100 | ~$0.15 | | 1,000 | ~$1.49 | | 10,000 | ~$14.90 | | 100,000 | ~$149.00 | > Flat-rate alternatives typically charge $29–$49/month regardless of usage. > At 10,000 results/month, this scraper costs significantly less with no commitment. Use the **Max results** cap in the input to control your spend exactly. *** ### Pricing This actor uses **Pay Per Result** pricing at **$1.49 per 1,000 results**. | Volume | Cost | |---|---| | 100 results | $0.15 | | 1,000 results | $1.49 | | 10,000 results | $14.90 | No subscription fees. Pay only for successfully scraped listings. *** ### Performance | Run size | Approx. time | Notes | |---|---|---| | 100 results | ~2 min | Default, with detail pages | | 1,000 results | ~15 min | Detail pages fetched | | 10,000 results | ~2.5 hrs | Full detail mode | | 10,000 results | ~20 min | Listing mode (`fetchDetails: false`) | *** ### Known limitations - **Publish date:** posao.hr does not display when a job was published — only the application deadline is available. `publishDate` and `publishDateISO` are always `null`. - **Salary:** Not disclosed by all employers — `salary`, `salaryMin`, and `salaryMax` will be `null` when unavailable. - **Apply URL:** Points to posao.hr's internal application routing page (`/prijava/...`). Some jobs redirect to external ATS systems; others display an on-site application form after login. - **Company name (listing mode):** When `fetchDetails` is disabled, `company` will always be `null` — it is only available on the detail page. - **Description format:** Employers on posao.hr use free-form HTML for job descriptions. Structure and completeness vary widely by employer. *** ### Technical details - **Source:** posao.hr — Croatia's largest job board - **Memory:** 256 MB - **Repost storage:** KeyValueStore `posao-hr-scraper-job-dedup`, 90-day TTL - **Retry:** Automatic retry on network errors, exponential backoff, 3 attempts per request *** ### Additional services Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to — we build on request. *** *Built by [unfenced-group](https://apify.com/unfenced-group) · Issues? Open a ticket or send a message.* # Actor input Schema ## `searchQuery` (type: `string`): Keyword(s) to search for (e.g. 'prodavac', 'inženjer', 'menadžer'). Leave empty to browse all jobs. ## `location` (type: `string`): Filter by Croatian county. Leave empty for all regions. ## `category` (type: `string`): Filter by job category. Leave empty for all categories. ## `daysOld` (type: `integer`): Only return jobs published within this many days. Leave empty for no date restriction. ## `salaryOnly` (type: `boolean`): When enabled, only return jobs that publicly display a salary. ## `fetchDetails` (type: `boolean`): Fetch the full job detail page for each result. Recommended — the listing page alone provides only title and location. Disable for a fast, minimal output. ## `skipReposts` (type: `boolean`): Skip jobs already seen in previous runs (detected via 90-day cross-run deduplication). ## `maxResults` (type: `integer`): Maximum number of results to return. ## `startUrls` (type: `array`): Optional list of specific posao.hr job URLs to scrape directly (e.g. https://www.posao.hr/oglasi/naziv/123456/). Overrides keyword search. ## Actor input object example ```json { "searchQuery": "", "location": "", "category": "", "salaryOnly": false, "fetchDetails": true, "skipReposts": false, "maxResults": 5, "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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/posao-hr-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 = {} # Run the Actor and wait for it to finish run = client.actor("unfenced-group/posao-hr-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 '{}' | apify call unfenced-group/posao-hr-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/posao-hr-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Posao.hr Scraper", "description": "Extract structured job data from Posao.hr Keyword, county, category filters. Salary, job type, qualifications. No API key required.", "version": "0.0", "x-build-id": "X12nhNw1CRR3HRUkj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~posao-hr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-posao-hr-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~posao-hr-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-posao-hr-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~posao-hr-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-posao-hr-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": { "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword(s) to search for (e.g. 'prodavac', 'inženjer', 'menadžer'). Leave empty to browse all jobs.", "default": "" }, "location": { "title": "County", "enum": [ "", "00", "01", "43", "35", "20", "52", "47", "48", "49", "53", "40", "31", "34", "51", "22", "44", "21", "42", "33", "32", "23", "99" ], "type": "string", "description": "Filter by Croatian county. Leave empty for all regions.", "default": "" }, "category": { "title": "Job category", "enum": [ "", "1", "2", "5", "7", "36", "4", "8", "9", "21", "39", "35", "16", "38", "37", "34", "20", "22", "12", "40", "28", "41", "29", "23", "19", "33", "14" ], "type": "string", "description": "Filter by job category. Leave empty for all categories.", "default": "" }, "daysOld": { "title": "Max age (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only return jobs published within this many days. Leave empty for no date restriction." }, "salaryOnly": { "title": "Salary disclosed only", "type": "boolean", "description": "When enabled, only return jobs that publicly display a salary.", "default": false }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Fetch the full job detail page for each result. Recommended — the listing page alone provides only title and location. Disable for a fast, minimal output.", "default": true }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Skip jobs already seen in previous runs (detected via 90-day cross-run deduplication).", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of results to return.", "default": 5 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of specific posao.hr job URLs to scrape directly (e.g. https://www.posao.hr/oglasi/naziv/123456/). Overrides keyword search.", "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 } } } } } } } } } } ```