{ "openapi": "3.0.1", "info": { "title": "Randstad Jobs Scraper", "description": "Scrape job listings from Randstad Germany, Switzerland and the United Kingdom in one run. Title, company, location, hours, salary, categories and dates per job, plus full description and consultant contact with details. Pay-per-result.", "version": "0.1", "x-build-id": "zGpEcdOp0evSJZy0G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nanoscrape~randstad-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nanoscrape-randstad-jobs-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/nanoscrape~randstad-jobs-scraper/runs": { "post": { "operationId": "runs-sync-nanoscrape-randstad-jobs-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/nanoscrape~randstad-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-nanoscrape-randstad-jobs-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": { "countries": { "title": "Countries", "type": "array", "description": "Which Randstad sites to search: DE (Germany), CH (Switzerland), UK (United Kingdom). Each country runs every search keyword.", "items": { "type": "string", "enum": [ "DE", "CH", "UK" ], "enumTitles": [ "Germany", "Switzerland", "United Kingdom" ] }, "default": [ "DE" ] }, "searchQueries": { "title": "Search Keywords", "type": "array", "description": "One or more keywords such as a job title or field. Each keyword runs as its own search in every country. Leave empty to list all jobs. Jobs found by several searches are returned once.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "array", "description": "Optional. Only jobs whose city, region, location text or postal code start matches one of these places are returned (for example Berlin, Zurich, Manchester or 80). In Germany and the UK, a keyword plus a place is searched directly on Randstad (fast). Otherwise the jobs found by the search are filtered, so combine it with a keyword to keep the search narrow.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted Within Days", "minimum": 0, "type": "integer", "description": "Only return jobs posted within the last N calendar days (UTC, today included). Older jobs are dropped before they are charged. 0 = no limit.", "default": 0 }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of jobs in total over all countries and searches. 0 = no limit.", "default": 100 }, "maxResultsPerQuery": { "title": "Max Results Per Search", "minimum": 0, "type": "integer", "description": "Maximum number of jobs per country and keyword. 0 = no limit.", "default": 50 }, "includeDetails": { "title": "Include Job Details", "type": "boolean", "description": "Also read each job page. Adds the full description as text and HTML, requirements, coordinates, consultant contact and expiry date; Germany and the United Kingdom add responsibilities, street, update dates, apply link and the exact country. Slower.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional Randstad search URLs, for example https://www.randstad.de/jobs/pflege/ or https://www.randstad.co.uk/jobs/nurse/. Each URL runs as one more search; page numbers in the URL are ignored.", "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }