{ "openapi": "3.0.1", "info": { "title": "Posao.hr Scraper: Croatia Jobs + Salary", "description": "Scrape Posao.hr (www.posao.hr) job listings into clean JSON: title, company, location, salary normalized to EUR/month, application deadline, tags, optional full description. Pay per result, no subscription.", "version": "0.1", "x-build-id": "oLqDEyAcXhcfg6qvk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ceejobs~posao-hr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ceejobs-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/ceejobs~posao-hr-scraper/runs": { "post": { "operationId": "runs-sync-ceejobs-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/ceejobs~posao-hr-scraper/run-sync": { "post": { "operationId": "run-sync-ceejobs-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Job title, skill or company words. posao.hr has no keyword search a crawler can address, so these filter the full listing client-side: without an occupation or field filter under 'Board-specific filters' the run walks ~337 pages of 15 rows to apply them. Croatian words work best. See the README.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or region in the board's own spelling, with or without diacritics (e.g. Zagreb, Split, Šibenik). Matched against each row's own place of work, because the board's place filter lives on a path its robots.txt disallows. Optional." }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many jobs. Controls cost: $2 per 1,000 jobs.", "default": 100 }, "includeDetails": { "title": "Fetch job detail pages", "type": "boolean", "description": "Adds description, expiry date and better salary data. Costs an extra $2 per 1,000 jobs and is slower (board-dependent, roughly 1.5–10×).", "default": false }, "postedWithinDays": { "title": "Posted within days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only keep jobs posted in the last N days. 0 = no filter.", "default": 0 }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Listing URLs from the board to crawl directly instead of keywords.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "extra": { "title": "Board-specific filters (advanced)", "type": "object", "description": "occupation: a posao.hr occupation slug (e.g. programer, prodavac) → crawls /zanimanja//; field: a field slug (e.g. informatika-i-telekomunikacije) → /djelatnosti//. Use one of them; keywords alone filter the whole board client-side (~337 pages)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy groups only; residential groups and custom proxy URLs are rejected. The datacenter pool is enough for this board." } } }, "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 } } } } } } } } } }