{ "openapi": "3.0.1", "info": { "title": "VDAB.be Scraper", "description": "[💰 $1.4 / 1K] Extract job vacancies from VDAB.be, the Flemish public employment service. Search by keyword and location, filter by contract type and sort order, and get titles, companies, salaries, contract types, requirements, descriptions, bottleneck-job flags, and contact details.", "version": "1.0", "x-build-id": "0TkymqqaOgaN6O5Px" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~vdab-be-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-vdab-be-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/solidcode~vdab-be-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-vdab-be-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/solidcode~vdab-be-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-vdab-be-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 Keywords", "maxItems": 50, "type": "array", "description": "Job titles or keywords to search for, such as 'software engineer', 'verpleegkundige', or 'magazijnier'. Each keyword runs a separate search and the results are merged and de-duplicated. Up to 50 keywords per run. Leave empty if you only want to use direct VDAB URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Direct VDAB URLs", "maxItems": 100, "type": "array", "description": "Paste full VDAB search-result URLs (for example https://www.vdab.be/vindeenjob/vacatures?trefwoord=verpleegkundige) and/or individual vacancy-page URLs. Any filters baked into a search URL are scraped exactly as-is. To keep a location filter from a pasted search URL, set the Location field above as well, since a pasted URL may carry only the place name and not VDAB's internal location code. Useful when you have already dialed in a search on the VDAB website. Up to 100 URLs per run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "A city or municipality in Flanders or Belgium, such as 'Antwerpen', 'Gent', 'Brussel', or 'Hasselt'. Leave empty to search all locations." }, "contractType": { "title": "Contract Type", "enum": [ "", "regular", "service-vouchers", "interim", "social-economy" ], "type": "string", "description": "Filter by employment category. Leave on 'Any' to include all categories.", "default": "" }, "sort": { "title": "Sort By", "enum": [ "standaard", "datum" ], "type": "string", "description": "Choose the order in which vacancies are collected.", "default": "standaard" }, "maxResults": { "title": "Max Results per Search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of vacancies to collect per search keyword (up to 2,000). Use 50 for a quick scan or a higher number for deep research. Small requests return about as many vacancies as you ask for; for larger requests the final count rounds up to the end of the last full page (about 50), so it can slightly overshoot this number.", "default": 100 }, "includeJobDetails": { "title": "Fetch Full Job Details", "type": "boolean", "description": "Fetch the full description, requirements, salary, and contact details from each vacancy's detail page. Leave on for the richest data. Turn off for faster, lighter scans — the description, requirements, salary, and contact fields will then be empty.", "default": true }, "includeRawData": { "title": "Include Raw Data", "type": "boolean", "description": "Attach the raw source payload to each record (as 'rawListing' and 'rawDetail') for advanced analysis. Most users can leave this off.", "default": false } } }, "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 } } } } } } } } } }