{ "openapi": "3.0.1", "info": { "title": "Work.ua Scraper: Ukraine Jobs, Salaries & Companies", "description": "Scrape job listings from Work.ua, Ukraine's largest private job board (9M+ monthly visitors). Returns title, company, city, oblast, UAH salary, employment type, remote type, wartime deferment flag, and full description.", "version": "1.2", "x-build-id": "rygJhf0tnV0nC36gV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~work-ua-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-work-ua-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/santamaria-automations~work-ua-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-work-ua-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/santamaria-automations~work-ua-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-work-ua-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "One or more job titles or keywords to search on Work.ua. Each entry runs as a separate search. Ukrainian keywords give best results. Examples: 'програміст', 'менеджер', 'бухгалтер', 'маркетолог', 'водій'.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Direct Work.ua search result URLs to crawl. Example: https://www.work.ua/jobs/?search=developer®ion=39", "items": { "type": "string" } }, "location": { "title": "Location (City)", "type": "string", "description": "Ukrainian city to filter results. Accepts Ukrainian or English names. Examples: 'Київ', 'Kyiv', 'Харків', 'Kharkiv', 'Одеса', 'Одеса', 'Дніпро', 'Львів', 'Запоріжжя'. Leave empty for all of Ukraine. Use 'Дистанційно' or 'Remote' for remote-only jobs." }, "sortBy": { "title": "Sort By", "enum": [ "newest", "salary" ], "type": "string", "description": "Sort order for search results. 'newest' returns jobs by date (platform default, recommended for scheduled runs). 'salary' returns jobs ordered by highest salary first (Найвища зарплата). Work.ua exposes exactly these two sort options in its UI.", "default": "newest" }, "includeJobDetails": { "title": "Include Full Job Details", "type": "boolean", "description": "When enabled, fetches the full job detail page for each listing to populate description_full, description_html, company_website, employment_type, remote_type, contact emails/phones. Charges the job-detail-result PPE event instead of job-serp-result.", "default": false }, "includeCompanyDetails": { "title": "Include Company Details", "type": "boolean", "description": "Surface company website from the job detail page. Requires includeJobDetails.", "default": false }, "maxResults": { "title": "Max Total Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Total cap across all search queries.", "default": 5 }, "maxResultsPerQuery": { "title": "Max Results per Query", "minimum": 1, "type": "integer", "description": "Maximum results per individual search keyword or URL.", "default": 5 }, "maxConcurrency": { "title": "Max Concurrent Browsers", "minimum": 1, "maximum": 3, "type": "integer", "description": "Reserved for future parallel-task support. Camoufox is memory-heavy so tasks run sequentially today.", "default": 1 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }