{ "openapi": "3.0.1", "info": { "title": "VDAB.be Job Scraper", "description": "Scrape job listings from VDAB.be — Belgium's public employment service and the largest Flemish job board. Filter by keyword, location, province, contract type and occupational field. Full descriptions in HTML, text and Markdown. No API key required.", "version": "1.0", "x-build-id": "6jXBnfLqpc1ByxFGf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~vdab-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-vdab-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~vdab-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-vdab-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~vdab-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-vdab-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. 'verpleegkundige', 'software developer'). Leave empty to return all vacancies.", "default": "" }, "location": { "title": "Location", "type": "string", "description": "Municipality or city to filter results (e.g. 'Antwerpen', 'Gent', 'Brussel'). Leave empty for all of Belgium.", "default": "" }, "contractType": { "title": "Contract type", "enum": [ "", "vast", "interim", "interim-vast", "student", "freelance", "flexi", "diensten" ], "type": "string", "description": "Filter by contract type. Leave empty for all types.", "default": "" }, "workType": { "title": "Work type", "enum": [ "", "full-time", "part-time" ], "type": "string", "description": "Filter by full-time or part-time.", "default": "" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of job listings to return.", "default": 200 }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch full job description, requirements, benefits, apply URL, education level, job domain, and company website from the detail API.", "default": true }, "daysOld": { "title": "Max age (days)", "minimum": 0, "type": "integer", "description": "Only return jobs posted within this many days. Leave empty or 0 for all jobs." }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Skip jobs already seen in previous runs. Uses a 90-day cross-run deduplication cache.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "List of specific VDAB vacancy URLs to scrape (e.g. https://www.vdab.be/vindeenjob/vacature/73351243). When provided, skips the search phase entirely.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQuery2": { "title": "Search query 2", "type": "string", "description": "Optional second keyword — scraped in the same run and merged with the first query results.", "default": "" }, "searchQuery3": { "title": "Search query 3", "type": "string", "description": "Optional third keyword — scraped in the same run and merged with the first query results.", "default": "" }, "province": { "title": "Province", "enum": [ "", "antwerpen", "oost-vlaanderen", "west-vlaanderen", "vlaams-brabant", "limburg", "brussel", "henegouwen", "luik", "luxembourg", "namen", "waals-brabant" ], "type": "string", "description": "Filter by Belgian province. Leave empty for all provinces.", "default": "" } } }, "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 } } } } } } } } } }