{ "openapi": "3.0.1", "info": { "title": "DOU.ua Job Scraper", "description": "Scrape job listings from DOU.ua — Ukraine's largest IT job board. Filter by category, city, experience and keyword.", "version": "0.0", "x-build-id": "Gf6INZgrCvv6ZYPLL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~dou-ua-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-dou-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~dou-ua-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-dou-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~dou-ua-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-dou-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 keywords", "type": "string", "description": "Filter by keyword (searches title and description). Example: \"Python\", \"senior developer\".", "default": "" }, "category": { "title": "Job category", "enum": [ "", ".NET", "Account Manager", "AI/ML", "Analyst", "Android", "Animator", "Architect", "Artist", "Assistant", "Big Data", "Blockchain", "C++", "C-level", "Copywriter", "Data Engineer", "Data Science", "DBA", "Design", "DevOps", "Embedded", "Engineering Manager", "Erlang", "ERP/CRM", "Finance", "Flutter", "Front End", "Golang", "Hardware", "HR", "iOS/macOS", "Java", "Legal", "Marketing", "No-code", "Node.js", "Office Manager", "Other", "PHP", "Product Manager", "Project Manager", "Python", "QA", "React Native", "Ruby", "Rust", "Sales", "Salesforce", "SAP", "Scala", "Scrum Master", "Security", "SEO", "Support", "SysAdmin", "Technical Writer", "Unity", "Unreal Engine", "Військова справа" ], "type": "string", "description": "Filter by job category. Leave empty for all categories.", "default": "" }, "city": { "title": "City", "type": "string", "description": "Filter by city. Examples: \"Київ\", \"Львів\", \"Харків\", \"Одеса\". DOU.ua has no dedicated remote filter — scrape without city filter and check the isRemote field in results instead.", "default": "" }, "experience": { "title": "Experience Level", "enum": [ "", "0-1", "1-3", "3-5", "5plus" ], "type": "string", "description": "Filter by required years of experience.", "default": "" }, "daysOld": { "title": "Max Age (days)", "minimum": 0, "type": "integer", "description": "Only return listings posted within the last N days. Set to 0 to return all listings." }, "fetchDetails": { "title": "Include full job details", "type": "boolean", "description": "ON: fetches full job description, salary, company info, and all details. OFF: returns basic listing info only (faster, lower cost).", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of DOU.ua URLs to scrape. Two kinds are accepted: a listing or search page such as https://jobs.dou.ua/vacancies/?category=.NET (all matching vacancies are scraped), or a single vacancy page such as https://jobs.dou.ua/companies/acme/vacancies/123456/ (that one vacancy is scraped). When provided, the search filters above are ignored. Example: [\"https://jobs.dou.ua/vacancies/?category=.NET&city=Київ\"]", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return. Set to 0 for no limit (scrapes all matching results).", "default": 100 }, "telegramToken": { "title": "Telegram bot token", "type": "string", "description": "Bot token from @BotFather, e.g. '110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw'. Requires Telegram chat ID below." }, "telegramChatId": { "title": "Telegram chat ID", "type": "string", "description": "Chat or channel ID the bot posts to, e.g. '-1001234567890'. Get it from @userinfobot." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Discord channel webhook, e.g. 'https://discord.com/api/webhooks/…'. Channel settings → Integrations → Webhooks." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Slack incoming webhook, e.g. 'https://hooks.slack.com/services/…'." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone number ID", "type": "string", "description": "Meta Cloud API phone number ID, e.g. '106540352242922'. Requires access token and recipient below." }, "whatsappAccessToken": { "title": "WhatsApp access token", "type": "string", "description": "Meta Cloud API access token for the WhatsApp Business account." }, "whatsappTo": { "title": "WhatsApp recipient", "type": "string", "description": "Recipient phone number in international format, e.g. '31612345678'." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with site, query, result counts and the newest items, e.g. 'https://example.com/hooks/jobs'." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Optional extra HTTP headers for the webhook request, e.g. {\"Authorization\": \"Bearer abc123\"}." }, "notificationLimit": { "title": "Items per notification", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum number of results shown in a notification message. Default 10, cap 25.", "default": 10 }, "notifyOnlyChanges": { "title": "Notify only on changes", "type": "boolean", "description": "Only send a notification when the run found new or changed items. Applies when incremental tracking is active; full runs with results always notify.", "default": 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 } } }, "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 } } } } } } } } } }