{ "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": "T45vrbYAF8DkEyuBM" }, "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": { "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword, e.g. 'developer' or 'verpleegkundige'. Leave empty for all vacancies." }, "keyword2": { "title": "Keyword 2", "type": "string", "description": "Optional second keyword to scrape in the same run." }, "keyword3": { "title": "Keyword 3", "type": "string", "description": "Optional third keyword to scrape in the same run." }, "location": { "title": "Location", "type": "string", "description": "Filter by city or municipality, e.g. 'Gent' or 'Antwerpen'. Matched client-side." }, "province": { "title": "Province", "type": "string", "description": "Filter by province, e.g. 'oost-vlaanderen' or 'Limburg'. Matched client-side." }, "contractType": { "title": "Contract type", "type": "string", "description": "Filter by contract type, e.g. 'Vaste Job' or 'Interim'. Matched client-side." }, "workRegime": { "title": "Work regime", "type": "string", "description": "Filter by work schedule, e.g. 'voltijds' or 'Dagwerk'. Matched client-side." }, "sort": { "title": "Sort order", "enum": [ "standaard", "recent", "relevantie" ], "type": "string", "description": "Sort order for search results.", "default": "standaard" }, "maxResults": { "title": "Max results", "type": "integer", "description": "Maximum number of vacancies to collect (1–10000)." }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Fetch each vacancy's detail page for full description and salary. Slower and more expensive. Default: false (list data only — still returns 9+ fields).", "default": false }, "daysOld": { "title": "Max age (days)", "type": "integer", "description": "Only include vacancies published within the last N days. Leave empty for all." }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Skip vacancies already seen in previous runs (based on 90-day fingerprint store).", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Scrape specific vacancy URLs directly, e.g. https://www.vdab.be/vindeenjob/vacatures/12345.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "requestDelayMs": { "title": "Request delay (ms)", "type": "integer", "description": "Delay between API requests in milliseconds. Increase to reduce server load.", "default": 150 }, "maxPagesToScan": { "title": "Max pages to scan", "type": "integer", "description": "Maximum search result pages to scan (1 page = 25 items). Increase when using province/workRegime filters with no keyword. Default: 200 pages (5,000 items).", "default": 200 } } }, "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 } } } } } } } } } }