{ "openapi": "3.0.1", "info": { "title": "StepStone Jobs Scraper & API: Salary Estimates, Germany", "description": "Scrape StepStone.de and StepStone.at jobs with salaries for most office and IT jobs (StepStone's own estimate, hidden in search), exact-match filter, English jobs, all site filters, min salary, address, company size, job alerts. Excel, CSV, JSON.", "version": "0.1", "x-build-id": "X8EV0QqEv0ZNWR86w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~stepstone-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-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/s_actors~stepstone-jobs-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-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/s_actors~stepstone-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-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": "๐Ÿ”Ž Keywords", "type": "array", "description": "Job title, skill or company, one per line, in German or English: \"data analyst\", \"Softwareentwickler\", \"Pflegefachkraft\", \"SAP\", \"Werkstudent\". Each keyword is searched in each location.", "items": { "type": "string" } }, "locations": { "title": "๐Ÿ“ Locations", "type": "array", "description": "City, postal code, state or country as on StepStone: \"Berlin\", \"Mรผnchen\", \"10115\", \"Bayern\", \"Deutschland\", \"Wien\". Empty = the whole country.", "items": { "type": "string" } }, "country": { "title": "๐ŸŒ StepStone site", "enum": [ "de", "at" ], "type": "string", "description": "stepstone.de has StepStone salary estimates; stepstone.at ads state the pay by law, it is read from the ad text.", "default": "de" }, "radiusKm": { "title": "๐Ÿ“ Radius, km", "minimum": 0, "maximum": 200, "type": "integer", "description": "Around the location, as on the site (5, 10, 20, 30, 40, 50, 75, 100). Empty = StepStone default (30 km)." }, "maxJobsPerSearch": { "title": "๐Ÿ”ข Max jobs per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Per keyword and location (and per search link). StepStone serves 25 jobs a page and goes up to page 400.", "default": 100 }, "matchType": { "title": "๐ŸŽฏ Match type", "enum": [ "all", "exactAndNearby", "exactOnly" ], "type": "string", "description": "StepStone pads a search with \"similar\" job titles and jobs outside the place: \"data analyst\" in Berlin = 1 018 results, only 44 exact. Every row has matchType = exact / similar / nearby. Removed jobs are free.", "default": "all" }, "postedWithin": { "title": "๐Ÿ•’ Posted within", "enum": [ "anyTime", "past24Hours", "past3Days", "pastWeek", "past2Weeks", "pastMonth" ], "type": "string", "description": "Only jobs published in this period.", "default": "anyTime" }, "remote": { "title": "๐Ÿ  Home office", "enum": [ "any", "remote", "hybrid" ], "type": "string", "description": "StepStone's home office filter.", "default": "any" }, "language": { "title": "๐Ÿ—ฃ๏ธ Ad language", "enum": [ "any", "en", "de" ], "type": "string", "description": "English = jobs in Germany written in English (for English speakers and expats).", "default": "any" }, "contractTypes": { "title": "๐Ÿ“„ Contract type", "type": "array", "description": "Any of the selected. Empty = all.", "items": { "type": "string", "enum": [ "permanent", "fixedTerm", "workingStudent", "internship", "traineeEntryLevel", "apprenticeship", "freelance", "temporaryAgency", "thesis", "salesAgent" ], "enumTitles": [ "Permanent (Feste Anstellung)", "Fixed-term (Befristet)", "Working student (Werkstudent)", "Internship (Praktikum)", "Trainee / entry level", "Apprenticeship / studies (Ausbildung)", "Freelance / project", "Temporary agency work (Arbeitnehmerรผberlassung)", "Thesis (Bachelor / Master)", "Sales agent (Handelsvertreter)" ] } }, "experience": { "title": "๐ŸŽ“ Experience", "type": "array", "description": "Any of the selected. Empty = all.", "items": { "type": "string", "enum": [ "noExperience", "experienced", "management" ], "enumTitles": [ "No experience needed", "With professional experience", "With management responsibility" ] } }, "workTypes": { "title": "โฑ๏ธ Working hours", "type": "array", "description": "Empty = both.", "items": { "type": "string", "enum": [ "fullTime", "partTime" ], "enumTitles": [ "Full-time", "Part-time" ] } }, "quickApplyOnly": { "title": "โšก Quick apply only", "type": "boolean", "description": "Only jobs with StepStone \"Schnelle Bewerbung\" (apply with the StepStone profile).", "default": false }, "minYearlySalary": { "title": "๐Ÿ’ถ Min salary per year, โ‚ฌ", "minimum": 0, "type": "integer", "description": "Only jobs whose salary (StepStone estimate or stated in the ad), converted to a year, reaches this amount at the top of the range. Jobs without salary are left out (free)." }, "onlyWithSalary": { "title": "๐Ÿ’ถ Only jobs with salary", "type": "boolean", "description": "Skip jobs without a salary (free).", "default": false }, "jobPages": { "title": "๐Ÿ“‘ Job pages", "enum": [ "withSalary", "all", "none" ], "type": "string", "description": "StepStone hides the salary in search results; the job page shows StepStone's own estimate. A job page also adds the full description split into tasks / requirements / offer, street address with coordinates, contract type, company size, industries and benefits. Charged per job page.", "default": "withSalary" }, "titleInclude": { "title": "โœ… Title must contain", "type": "array", "description": "Keep only jobs whose title contains one of these words (case-insensitive).", "items": { "type": "string" } }, "titleExclude": { "title": "๐Ÿšซ Title must not contain", "type": "array", "description": "Drop jobs whose title contains any of these words: \"Senior\", \"Praktikum\", \"Werkstudent\".", "items": { "type": "string" } }, "companyExclude": { "title": "๐Ÿข Exclude companies", "type": "array", "description": "Drop jobs of companies whose name contains any of these words (e.g. staffing agencies: \"Hays\", \"Randstad\", \"Personal\").", "items": { "type": "string" } }, "skipSponsored": { "title": "๐Ÿ“ข Skip sponsored jobs", "type": "boolean", "description": "Drop jobs StepStone marks as sponsored.", "default": false }, "skipDuplicates": { "title": "โ™ป๏ธ Skip reposts", "type": "boolean", "description": "The same title + company + location only once (companies post one job many times).", "default": true }, "onlyNewJobs": { "title": "๐Ÿ”” Only new jobs (job alerts)", "type": "boolean", "description": "Return only jobs not seen in earlier runs with the same monitor name. Schedule the Actor daily to get new jobs only (seen jobs are free).", "default": false }, "monitorName": { "title": "๐Ÿท๏ธ Monitor name", "type": "string", "description": "Separate memory for each alert: \"berlin-data\", \"wien-sap\"." }, "searchUrls": { "title": "๐Ÿ”— StepStone search links", "type": "array", "description": "Search pages copied from the browser with any filters: stepstone.de/jobs/data-analyst/in-berlin?fdl=en&wfh=2. Also /work/... links and stepstone.at.", "items": { "type": "string" } }, "jobUrls": { "title": "๐Ÿ“Œ Job links", "type": "array", "description": "Full data of specific jobs: stepstone.de/stellenangebote--...---inline.html links or job IDs (stepstone.de).", "items": { "type": "string" } }, "sortBy": { "title": "โ†•๏ธ Sort", "enum": [ "relevance", "newest" ], "type": "string", "description": "Order of StepStone results. With a 3-day, 2-week or month window newest first is used automatically.", "default": "relevance" }, "descriptionFormat": { "title": "๐Ÿ“ Job description", "enum": [ "text", "html", "both", "none" ], "type": "string", "description": "Full description from the job page (tasks, requirements and offer are also separate fields). Without a job page a short snippet is returned.", "default": "text" }, "maxConcurrency": { "title": "โš™๏ธ Parallel requests", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many StepStone pages load at once.", "default": 10 }, "debugLog": { "title": "๐Ÿž Debug log", "type": "boolean", "description": "Log every failed attempt.", "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 }, "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 } } } } } } } } } }