{ "openapi": "3.0.1", "info": { "title": "StepStone New Jobs Scraper - stepstone.de Germany Jobs Feed", "description": "StepStone new jobs scraper for stepstone.de: StepStone DE jobs by keyword, city and radius with salary range, company page, home-office flag and posting date. New-jobs-only feed for daily alerts, 24h and 7-day filters, optional full description. No login.", "version": "1.0", "x-build-id": "O0XiA5HUYGxFF1Ft4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~stepstone-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-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/kamerozkan~stepstone-jobs-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-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/kamerozkan~stepstone-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Job titles or keywords as you would type them on stepstone.de, for example \"Software Entwickler\", \"Data Engineer\" or \"Pflegefachkraft\". Each term is searched separately and duplicates are removed. Leave empty to get all jobs in the location.", "default": [ "Software Entwickler" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or region in Germany, for example \"Berlin\", \"München\" or \"Hamburg\". Leave empty to search all of Germany.", "default": "Berlin" }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius around the location in kilometres (StepStone default 30). Used only when a location is set.", "default": 30 }, "searchUrls": { "title": "StepStone search URLs", "type": "array", "description": "Optional. Result-list URLs copied from stepstone.de, for example https://www.stepstone.de/jobs/vollzeit/software-entwickler/in-berlin or a URL with filters already applied. Read in addition to the search terms; the filters below are added to them.", "items": { "type": "string" } }, "publishedWithin": { "title": "Published within", "enum": [ "any", "24h", "7d" ], "type": "string", "description": "Only jobs posted in the last 24 hours or the last 7 days (the StepStone \"Neuer als\" filter). Combine with Only new jobs and a daily schedule for a job alert feed.", "default": "any" }, "workFromHome": { "title": "Home office", "enum": [ "any", "partly", "only" ], "type": "string", "description": "Only jobs with partial home office (hybrid) or only fully remote jobs.", "default": "any" }, "contractTypes": { "title": "Contract types", "type": "array", "description": "Optional filter. Leave empty for all contract types.", "items": { "type": "string", "enum": [ "permanent", "fixed-term", "working-student", "apprenticeship", "internship", "trainee", "freelance", "temporary-agency" ], "enumTitles": [ "Permanent (Feste Anstellung)", "Fixed-term (Befristeter Vertrag)", "Working student (Werkstudent)", "Apprenticeship and dual study (Ausbildung, Studium)", "Internship (Praktikum)", "Trainee and entry programme", "Freelance and project work", "Temporary agency work" ] } }, "experience": { "title": "Experience level", "enum": [ "any", "entry-level", "with-experience", "management" ], "type": "string", "description": "Optional filter on the StepStone experience facet.", "default": "any" }, "language": { "title": "Job ad language", "enum": [ "any", "de", "en" ], "type": "string", "description": "Only job ads written in German or only in English.", "default": "any" }, "minSalaryEur": { "title": "Minimum salary (EUR per year)", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Optional. Only jobs whose StepStone salary range reaches at least this annual amount, for example 60000. StepStone steps are 10,000 to 100,000." }, "discipline": { "title": "Discipline", "type": "string", "description": "Optional StepStone discipline facet, written as on the site, for example \"IT\", \"Marketing\", \"Ingenieurwesen\" or \"Vertrieb und Verkauf\"." }, "sortBy": { "title": "Sort by", "enum": [ "date", "relevance" ], "type": "string", "description": "Newest jobs first (default) or StepStone relevance.", "default": "date" }, "includeNearbyJobs": { "title": "Include nearby jobs", "type": "boolean", "description": "StepStone adds jobs from nearby towns on top of the result count (matchType regional). Off by default: only the jobs StepStone counts as results (matchType main or semantic) are returned and charged.", "default": false }, "onlyNewJobs": { "title": "Only new jobs", "type": "boolean", "description": "Return only jobs that earlier runs with the same searches did not return. Use with an Apify Schedule for a StepStone new jobs feed: you pay only for new listings.", "default": false }, "historyKey": { "title": "History key", "type": "string", "description": "Optional name for the new-jobs-only history. Runs with the same key share one history. By default the key is derived from the searches and filters." }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many jobs. You are charged per job, so this also caps the cost of the run.", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy. By default the run uses German residential proxy (StepStone lets most datacenter connections time out); choose proxy groups here to override.", "default": { "useApifyProxy": 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 } } } } } } } } } }