{ "openapi": "3.0.1", "info": { "title": "robota.ua Scraper: Ukraine Job Vacancies", "description": "Scrape robota.ua job vacancies by keyword: title, employer, city, stated salary, posting time and link. Optionally open each vacancy for the full description, address, category, skills and the contacts the employer publishes. Filter by city, salary band and words. Unofficial.", "version": "0.1", "x-build-id": "5j4Qzym6aQCUZhnnI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~robota-ua-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-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/reventadata~robota-ua-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-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/reventadata~robota-ua-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Job titles or keywords, one robota.ua search per term (for example python, водій, sales manager). Leave empty to list the site's default-ranked vacancies across all topics.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Total number of vacancies to save across all queries. Each result page holds 20 vacancies.", "default": 100 }, "maxPages": { "title": "Maximum pages per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Result pages to walk per query (20 vacancies each). The Actor stops earlier at the last page the site has. The default of 10 gives up to 200 vacancies per query.", "default": 10 }, "includeDetails": { "title": "Fetch full vacancy pages", "type": "boolean", "description": "Open every kept vacancy to add the full description, exact posting time, address, category, skills, schedules and the contacts the employer publishes. This costs one extra request per vacancy, so runs are slower. Off: each row carries the listing snippet and relative posting time.", "default": false }, "city": { "title": "City", "type": "string", "description": "Keep only vacancies whose city name contains this text, ignoring case and accents (for example Київ or Львів). Applied after fetching, so combine it with a query; it does not widen the search." }, "minSalary": { "title": "Minimum salary", "minimum": 0, "type": "integer", "description": "Keep only vacancies whose stated salary range reaches at least this amount, as the site states it (the API gives no currency). Vacancies with no stated salary are dropped when this is set. Applied after fetching." }, "maxSalary": { "title": "Maximum salary", "minimum": 0, "type": "integer", "description": "Keep only vacancies whose stated salary range starts at or below this amount. Vacancies with no stated salary are dropped when this is set. Applied after fetching." }, "onlyWithSalary": { "title": "Only vacancies with a stated salary", "type": "boolean", "description": "Drop vacancies that state no salary figure.", "default": false }, "includeKeywords": { "title": "Must contain", "type": "array", "description": "Keep only vacancies whose title, company or listing snippet contains every one of these words, ignoring case and accents.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Drop vacancies whose title, company or listing snippet contains any of these words, ignoring case and accents.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "robota.ua sits behind Cloudflare, which challenged a home IP and passed a datacenter IP in testing. Apify Proxy is on by default with no group named; if runs report a block, try the residential group.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }