{ "openapi": "3.0.1", "info": { "title": "Robota.Ua Scraper", "description": "Scrape robota.ua — one of Ukraine's largest job boards. Extracts titles, structured UAH salary, company profiles and page links, skill tags, employment clusters and GPS coordinates. Filter by city, category, schedule, salary and date. No contact-person data. No API key required.", "version": "0.0", "x-build-id": "BnLivycVFm6R6iBbE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~robota-ua-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-robota-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/unfenced-group~robota-ua-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-robota-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/unfenced-group~robota-ua-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-robota-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keywords to search for, e.g. 'developer' or 'accountant'. Leave empty to return all vacancies." }, "cityId": { "title": "City ID", "type": "integer", "description": "robota.ua numeric city ID to filter by city (e.g. 1 = Kyiv, 2 = Dnipro, 4 = Odesa, 5 = Kharkiv). Leave empty for all cities." }, "scheduleId": { "title": "Schedule ID", "type": "integer", "description": "Employment schedule filter: 1 = full-time, 2 = part-time, 3 = remote, 4 = freelance, 5 = internship. Leave empty for all." }, "rubricIds": { "title": "Category IDs", "type": "array", "description": "Filter by one or more robota.ua category (rubric) IDs, e.g. [\"1\"] for IT/Computers. Leave empty for all categories.", "items": { "type": "string" } }, "salary": { "title": "Minimum Salary (UAH)", "type": "integer", "description": "Return only vacancies offering at least this monthly salary in UAH. Leave empty for any salary." }, "period": { "title": "Period (days)", "type": "integer", "description": "Return only vacancies published in the last N days, e.g. 1, 7 or 30. Leave empty for all." }, "language": { "title": "Language", "minimum": 1, "maximum": 2, "type": "integer", "description": "Response language for text fields: 1 = Ukrainian, 2 = Russian.", "default": 2 }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1500, "type": "integer", "description": "Maximum number of job listings to scrape. You are billed per result, so keep this low for test runs.", "default": 100 }, "fetchDetails": { "title": "Fetch Details", "type": "boolean", "description": "Fetch each vacancy's full description (HTML/Markdown), employer website, skill tags, clusters, branch, seniority level and agency flag. Slower and adds one request per listing, but far more complete.", "default": false }, "skipDedup": { "title": "Skip Deduplication", "type": "boolean", "description": "Disable deduplication and re-scrape all listings, including ones seen in previous runs.", "default": false } } }, "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 } } } } } } } } } }