{ "openapi": "3.0.1", "info": { "title": "StepStone Scraper", "description": "Scrape StepStone.de job listings with full descriptions, employer benefits and geo coordinates. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "NuozdGXnzN5BKn8mu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~stepstone-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-stepstone-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/parseforge~stepstone-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-stepstone-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/parseforge~stepstone-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-stepstone-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": { "startUrls": { "title": "StepStone URLs", "type": "array", "description": "Paste StepStone search result pages or single job ad pages, for example https://www.stepstone.de/jobs/software-engineer or https://www.stepstone.de/stellenangebote--...--14445878-inline.html. Leave empty to build the search from the fields below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchKeyword": { "title": "Keyword", "type": "string", "description": "Job title, skill or company to search for, exactly as you would type it into the StepStone search box. Ignored when StepStone URLs are supplied above." }, "location": { "title": "Location", "type": "string", "description": "City, region or postal code, for example Berlin, Nordrhein-Westfalen or 10115. Leave empty to search all of Germany." }, "searchRadius": { "title": "Search Radius", "enum": [ "", "100" ], "type": "string", "description": "StepStone collapses every radius below 100 km into one default catchment area, so only these two settings actually change the result count.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "1", "2" ], "type": "string", "description": "Relevance is StepStone's own ranking. Date returns the newest postings first, which is what you want for a daily job feed.", "default": "1" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "scrapeJobDetails": { "title": "Scrape Full Job Details", "type": "boolean", "description": "Open every job ad to add the full description, employer benefits, contract type, work type, industry, postal code and geo coordinates. Turn this off for a fast, listing-only run that uses one request per 25 jobs.", "default": true }, "postedWithin": { "title": "Posted Within", "enum": [ "", "age_1", "age_7" ], "type": "string", "description": "Only return postings published inside this window.", "default": "" }, "workFromHome": { "title": "Home Office", "enum": [ "", "1", "2" ], "type": "string", "description": "Filter by how much of the role can be done from home.", "default": "" }, "workType": { "title": "Work Type", "enum": [ "", "80001", "80002" ], "type": "string", "description": "Full time or part time.", "default": "" }, "contractType": { "title": "Contract Type", "enum": [ "", "222", "223", "220", "224", "225", "226", "227", "228", "229", "230", "231", "232", "221" ], "type": "string", "description": "StepStone's contract categories, in the site's own German wording.", "default": "" }, "experienceLevel": { "title": "Experience Level", "enum": [ "", "90001", "90002", "90003" ], "type": "string", "description": "Filter by the experience StepStone assigns to the posting.", "default": "" }, "discipline": { "title": "Discipline", "enum": [ "", "IT", "Ingenieurwesen", "Vertrieb und Verkauf", "Management", "Administration", "Gesundheit", "Soziales", "Bildung", "Handwerk", "Bauwesen", "Logistik", "Fertigung, Produktion", "Gastronomie, Hotellerie", "Buchhaltung", "Finanzen", "Banken", "Versicherungen", "Marketing", "Beratung", "Kundenservice", "Personal", "Wissenschaften", "Design", "Immobilien", "Kunst und Unterhaltung", "Gross- und Einzelhandel", "Reinigung", "Offentlicher Sektor" ], "type": "string", "description": "StepStone's job family, for example IT or Ingenieurwesen.", "default": "" }, "sector": { "title": "Sector", "enum": [ "", "21000", "23000", "29000", "15000", "17000", "26000", "12004", "14001", "19002", "19001", "19003", "25000", "28000", "9000", "27000", "16000", "30000", "12005", "12006", "13000", "20000", "24000", "10000", "3000", "7000", "1000", "31000", "32000", "2000", "18000", "12002" ], "type": "string", "description": "The employer's industry, using StepStone's own sector list.", "default": "" }, "jobLanguage": { "title": "Ad Language", "enum": [ "", "de", "en" ], "type": "string", "description": "The language the job ad itself is written in, as detected by StepStone. Useful for finding English-language roles in Germany.", "default": "" }, "applicationMethod": { "title": "Application Method", "enum": [ "", "INTERNAL", "EXTERNAL" ], "type": "string", "description": "Whether the application is completed on StepStone or on the employer's own website.", "default": "" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "StepStone is behind Akamai and only answers German residential IPs, so residential proxies with country DE are on by default. Changing this will usually stop the run from returning data.", "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 } } }, "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 } } } } } } } } } }