{ "openapi": "3.0.1", "info": { "title": "Intermediair Scraper — Dutch professional job board", "description": "Scrape intermediair.nl — Dutch professional job board for management and specialist roles. Extract recruiter contacts, structured salary ranges, full descriptions, and location data. Filter by contract, education, career, industry. Incremental tracking and compact output.", "version": "0.2", "x-build-id": "qf1cfJEAZUMiVCzTh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~intermediair-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-intermediair-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/blackfalcondata~intermediair-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-intermediair-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/blackfalcondata~intermediair-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-intermediair-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", "required": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Job search keywords." }, "country": { "title": "Country", "enum": [ "NL" ], "type": "string", "description": "Which market to search.", "default": "NL" }, "location": { "title": "Location", "type": "string", "description": "City or place name, resolved through Intermediair's address service." }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius around the resolved location.", "default": 40 }, "sort": { "title": "Sort", "enum": [ "relevance", "date" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "maxResults": { "title": "Max Results", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum total results (0 = unlimited).", "default": 25 }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Fetch full detail records for each job for enrichment and parity across runs. Disabled by default because search results already include the full useful payload.", "default": false }, "descriptionMaxLength": { "title": "Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N chars. 0 = no truncation.", "default": 0 }, "compact": { "title": "Compact Output", "type": "boolean", "description": "Core fields only (for AI-agent/MCP workflows).", "default": false }, "incrementalMode": { "title": "Incremental Mode", "type": "boolean", "description": "Compare against previous run state.", "default": false }, "stateKey": { "title": "State Key", "type": "string", "description": "Stable identifier for tracked universe." }, "emitUnchanged": { "title": "Emit Unchanged", "type": "boolean", "description": "Also emit jobs that have not changed since the last run (incrementalMode only).", "default": false }, "emitExpired": { "title": "Emit Expired", "type": "boolean", "description": "Also emit jobs that have disappeared since the last run (incrementalMode only).", "default": false }, "contractType": { "title": "Contract Type", "type": "string", "description": "Filter by contract type. Use the exact Intermediair term (e.g. \"Vast\", \"Tijdelijk\", \"Freelance\")." }, "educationLevel": { "title": "Education Level", "type": "string", "description": "Filter by minimum education level (e.g. \"HBO\", \"WO\", \"MBO\")." }, "careerLevel": { "title": "Career Level", "type": "string", "description": "Filter by career level (e.g. \"Ervaren\", \"Starter\", \"Senior\")." }, "industry": { "title": "Industry", "type": "string", "description": "Filter by industry. Use the exact Intermediair value, including slash forms where applicable (e.g. \"Overheid/Non-profit\", \"ICT\")." }, "category": { "title": "Job Category", "type": "string", "description": "Filter by job category. Use the exact parent/sub value from Intermediair's category list (e.g. \"Financieel/Accounting\", \"ICT/Softwareontwikkeling\"). Unknown values are rejected." }, "workingPlace": { "title": "Working Place", "type": "string", "description": "Filter by work location style (e.g. \"Hybride\", \"Op locatie\", \"Thuis\")." } } }, "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 } } } } } } } } } }