{ "openapi": "3.0.1", "info": { "title": "StepStone.de Scraper — Germany's Largest Job Board", "description": "Scrape Stepstone.de, Germany's largest job board. Returns job title, company, company logo, location, contract type, work schedule, labels, remote flags and full job descriptions. Keyword and location search, radius, date and contract filters, deduplication and start URLs.", "version": "0.0", "x-build-id": "c29PyhjtC5CIOEaWA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~stepstone-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-stepstone-de-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/unfenced-group~stepstone-de-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-stepstone-de-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/unfenced-group~stepstone-de-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-stepstone-de-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": { "searchQuery": { "title": "Search keywords", "type": "string", "description": "Job title, keyword, or skill to search for. Examples: \"Software Engineer\", \"Data Analyst\", \"Ingenieur\". Leave empty to browse all listings. Use searchQueries below to run multiple searches in one run.", "default": "" }, "searchQueries": { "title": "Multiple search queries", "type": "array", "description": "Run multiple keyword searches in a single actor run. Each item can be a plain string (\"Software Engineer\") or an object {\"query\": \"Ingenieur\", \"location\": \"München\"}. Results from all queries are combined. Takes precedence over Search keywords above when provided.", "default": [] }, "location": { "title": "Location", "type": "string", "description": "City, region, or Bundesland to filter by. Examples: \"Berlin\", \"München\", \"Bayern\". Leave empty to search all of Germany.", "default": "" }, "radius": { "title": "Search radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius in kilometres around the specified location. Set to 0 for exact location match.", "default": 40 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort results by relevance (default Stepstone ranking) or date (newest listings first).", "default": "relevance" }, "contractType": { "title": "Contract type", "enum": [ "", "FULL_TIME", "PART_TIME" ], "type": "string", "description": "Filter by working time. Stepstone.de only supports full-time and part-time filtering. Leave empty for all.", "default": "" }, "workFromHome": { "title": "Remote / work from home", "enum": [ "", "partial", "full" ], "type": "string", "description": "Filter by remote work availability. Leave empty for all listings." }, "daysOld": { "title": "Max listing age (days)", "minimum": 1, "type": "integer", "description": "Only return listings published within the last N days. Leave blank for all listings. Use 1 for today, 7 for the past week." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of job listings to return. Set to 0 for no limit. Default is 100 — increase for production runs.", "default": 100 }, "fetchDetails": { "title": "Include full job details", "type": "boolean", "description": "ON: fetches the full job description (HTML, text, Markdown) plus company and location details from each listing's detail page. OFF: returns listing data only (faster, lower cost).", "default": false }, "skipReposts": { "title": "Skip reposts (deduplication)", "type": "boolean", "description": "Skip listings already seen in previous runs. Uses a 90-day deduplication window stored in Key-Value Store. Ideal for daily incremental feeds — only new listings are returned.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste specific Stepstone.de search result URLs or job detail page URLs here. When provided, the search query and location filters above are ignored. Useful for pre-filtered searches or bookmarked pages.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }