{ "openapi": "3.0.1", "info": { "title": "StepStone Jobs Scraper: Germany, Austria & UK Totaljobs", "description": "Scrape job listings from StepStone Germany, StepStone Austria, Totaljobs and CWJobs by keyword and location: title, company, salary, remote or hybrid, benefits, skills, posting date and the full job description if you want it. Radius and date filters. No login. Pay per job.", "version": "0.1", "x-build-id": "gfsFxzJvMcgRyqNId" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~stepstone-totaljobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-stepstone-totaljobs-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/themineworks~stepstone-totaljobs-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-stepstone-totaljobs-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/themineworks~stepstone-totaljobs-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-stepstone-totaljobs-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Required. One job title or keyword per line, for example data analyst or Projektmanager. Each keyword is its own search; a job found by two keywords is returned and charged once. Up to 50 per run.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or postcode, typed the way you would on the site: Berlin, München, Wien, London, Manchester. Leave empty to search the whole country." }, "site": { "title": "Job board", "enum": [ "stepstone.de", "stepstone.at", "totaljobs.com", "cwjobs.co.uk" ], "type": "string", "description": "Which StepStone group job board to search.", "default": "stepstone.de" }, "maxResultsPerSearch": { "title": "Jobs per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Most jobs to return for each keyword. The sites show 25 jobs per page, so 25 is one page and 100 is four.", "default": 25 }, "postedWithinDays": { "title": "Posted within", "enum": [ "", "1", "3", "7", "14" ], "type": "string", "description": "Only jobs posted recently. Uses the site's own date filter. StepStone offers 24 hours and 7 days, so 3 and 14 days are finished by the posting date on each job. Totaljobs and CWJobs count a refreshed ad as new, so some jobs there show an older posted date.", "default": "" }, "radius": { "title": "Radius around the location", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search distance around the location. Kilometres on StepStone (5, 10, 20, 30, 40, 50, 75 or 100; the site default is 30). Miles on Totaljobs and CWJobs (0, 5, 10, 20 or 30; the site default is 10). Other values move to the nearest one the site offers. Leave empty for the site default." }, "workFromHome": { "title": "Home office", "enum": [ "", "remote", "hybrid" ], "type": "string", "description": "Only remote or hybrid jobs, using the site's own home office filter. On Totaljobs and CWJobs both choices use the site's single Work From Home filter.", "default": "" }, "exactMatchesOnly": { "title": "Exact matches only", "type": "boolean", "description": "On by default: you only get and pay for jobs that match your search. When the exact matches run out, StepStone and Totaljobs add similar job titles and jobs from outside your radius; turn this off to get those too. Every row says which kind it is in match_type.", "default": true }, "includeDescription": { "title": "Full job description", "type": "boolean", "description": "Also open each job's own page and add the full description, employment type, closing date and address details. Slower, and charged as an extra event per job that actually gets its description. A job whose page cannot be read is still returned, without the description and without that charge.", "default": false }, "allowUnblockerFallback": { "title": "Retry refused pages through an unblocking proxy", "type": "boolean", "description": "Search pages are read over a fast connection first. If the site refuses a page several times, try it through Apify's unblocking proxy, which is slower. Included in the price. Turn off to report such pages as refused instead.", "default": true } } }, "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 } } } } } } } } } }