{ "openapi": "3.0.1", "info": { "title": "StepStone Jobs Scraper: Germany Jobs, Salaries & New-Job Alerts", "description": "Scrape StepStone.de jobs by keyword and city: title, company, location, salary range (incl. StepStone's estimate), home office, publish date and benefits. Search many keyword × city pairs in one run and get only new jobs on scheduled runs.", "version": "0.1", "x-build-id": "9hIjSvictQTJuA4Va" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasmithlab~stepstone-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasmithlab-stepstone-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/datasmithlab~stepstone-jobs-scraper/runs": { "post": { "operationId": "runs-sync-datasmithlab-stepstone-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/datasmithlab~stepstone-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-datasmithlab-stepstone-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": { "keywords": { "title": "Job titles or keywords", "type": "array", "description": "One per line, e.g. 'Data Engineer', 'Pflegefachkraft', 'Python'. Each keyword is searched in each location below.", "items": { "type": "string" } }, "locations": { "title": "Cities", "type": "array", "description": "One per line, e.g. 'Berlin', 'München', 'Frankfurt am Main'. Leave empty to search all of Germany. Every keyword × city pair is its own search.", "items": { "type": "string" } }, "startUrls": { "title": "StepStone search URLs", "type": "array", "description": "Or paste StepStone.de search pages such as https://www.stepstone.de/jobs/data-engineer/in-berlin. Pages with filters, sorting or page numbers in the URL cannot be used (StepStone's robots.txt does not allow them).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Stop after this many job rows (you pay per row).", "default": 500 }, "workplace": { "title": "Home office", "enum": [ "any", "remoteOrHybrid", "remote" ], "type": "string", "description": "Filters are applied by the scraper; jobs that don't match are not charged.", "default": "any" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Only jobs published in the last N days. Leave empty for any date." }, "includeSimilarJobs": { "title": "Include nearby and similar jobs", "type": "boolean", "description": "StepStone fills thin searches with jobs from outside the city or with a related title. Off: only real matches. Sponsored 'you may also like' jobs are never included.", "default": false }, "onlyNewJobs": { "title": "Only new jobs (monitoring)", "type": "boolean", "description": "For scheduled runs: each run returns only jobs not seen in an earlier run with the same settings (changeType NEW). Jobs already seen are not returned and not charged. The first run returns everything as NEW.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "StepStone does not answer Apify's datacenter IPs, so German residential proxies are used by default (included in the price). When a request is refused, the scraper switches IP at most 3 times and then reports the search as blocked.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } } }, "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 } } } } } } } } } }