{ "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": "W8wwUIbJIHjkORTG2" }, "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 keywords", "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": "" }, "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 }, "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 }, "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 / region", "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": "" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of direct URLs to scrape specific pages. When provided, the search filters above are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of job listings to return.", "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 } } } } } } } } } }