StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts
Pricing
from $1.50 / 1,000 results
Scrape StepStone jobs from Germany (stepstone.de) and Austria (stepstone.at): title, company, location, employment type, industry and full job descriptions (text, HTML, Markdown). Filter by contract type, hours, experience, industry or federal state. Tag jobs NEW/UPDATED/EXPIRED and send alerts.
You can access the StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "Kl5KiHj4J8P251J6f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~stepstone-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-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/corvuslab~stepstone-jobs-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-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/corvuslab~stepstone-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-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": { "query": { "title": "🔑 Search keywords", "type": "string", "description": "Job title, skill, or company to search for (e.g. \"data analyst\"). Separate multiple searches with commas — each runs on its own and results are merged and de-duplicated." }, "location": { "title": "📍 Location", "type": "string", "description": "City or region to search in, e.g. \"Berlin\" or \"München\". Leave empty to search the whole country." }, "country": { "title": "🌍 Country edition", "enum": [ "de", "at" ], "type": "string", "description": "Which StepStone site to search.", "default": "de" }, "startUrls": { "title": "📋 Start URLs", "type": "array", "description": "Paste StepStone search-result URLs (with any filters already applied in your browser) or individual job URLs. Both are scraped directly.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "🔢 Max results", "minimum": 0, "type": "integer", "description": "Maximum number of records to return. Set 0 for unlimited (bounded by how many the search has).", "default": 25 }, "maxPages": { "title": "📄 Max pages per search", "minimum": 0, "type": "integer", "description": "Optional hard cap on how many result pages to fetch per search (25 jobs per page). Leave empty to page until Max results is reached." }, "ignoreUrlFailures": { "title": "⏭️ Ignore URL failures", "type": "boolean", "description": "Skip URLs that cannot be interpreted instead of failing the whole run.", "default": true }, "workFromHome": { "title": "🏠 Home-office jobs only", "type": "boolean", "description": "Return only jobs that offer remote / home-office work.", "default": false }, "contractType": { "title": "📃 Contract type", "enum": [ "", "permanent", "fixed_term", "working_student", "trainee", "apprenticeship", "internship", "freelance", "temp_agency", "franchise", "sales_rep", "thesis", "clerkship", "doctorate" ], "type": "string", "description": "Filter by employment / contract type.", "default": "" }, "workType": { "title": "🕘 Working hours", "enum": [ "", "full_time", "part_time" ], "type": "string", "description": "Filter by full-time or part-time.", "default": "" }, "experience": { "title": "🎓 Experience level", "enum": [ "", "none", "with_experience", "management" ], "type": "string", "description": "Filter by required experience level.", "default": "" }, "datePosted": { "title": "🗓️ Posted within", "enum": [ "", "1", "3", "7", "14" ], "type": "string", "description": "Only return jobs posted within this many days.", "default": "" }, "industry": { "title": "🏭 Industry / sector", "enum": [ "", "it_internet", "construction", "wholesale_retail", "health_social", "consulting_law_audit", "mechanical_plant_engineering", "hotel_gastronomy_catering", "real_estate", "electrical_precision_optics", "financial_services", "transport_logistics", "energy_water_waste", "public_sector_associations", "banking", "food_beverages", "agency_advertising_marketing_pr", "automotive", "leisure_tourism_culture_sport", "education_training", "other_services" ], "type": "string", "description": "Filter by industry sector.", "default": "" }, "bundesland": { "title": "🗺️ Federal state (stepstone.de)", "enum": [ "", "baden-wuerttemberg", "bayern", "berlin", "brandenburg", "bremen", "hamburg", "hessen", "mecklenburg-vorpommern", "niedersachsen", "nordrhein-westfalen", "rheinland-pfalz", "saarland", "sachsen", "sachsen-anhalt", "schleswig-holstein", "thueringen" ], "type": "string", "description": "Filter by German federal state (Bundesland). Overrides Location. Germany edition only.", "default": "" }, "jobLanguage": { "title": "🗣️ Job language", "enum": [ "", "de", "en" ], "type": "string", "description": "Only return job ads written in this language.", "default": "" }, "applicationMethod": { "title": "📨 Application method", "enum": [ "", "internal", "external" ], "type": "string", "description": "Filter by how you apply. Quick apply = apply directly on StepStone; external = apply on the company's own site.", "default": "" }, "onlyQuickApply": { "title": "⚡ Quick-apply jobs only", "type": "boolean", "description": "Shortcut for Application method = Quick apply. Return only jobs you can apply to directly on StepStone.", "default": false }, "excludeSponsored": { "title": "🚫 Exclude sponsored listings", "type": "boolean", "description": "Skip promoted / sponsored jobs (where isSponsored is true).", "default": false }, "radius": { "title": "📏 Search radius (km)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Widen the search around the chosen location, in kilometres. Only applies when a location is set." }, "sortBy": { "title": "↕️ Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the results.", "default": "relevance" }, "includeDetails": { "title": "🔬 Fetch full details", "type": "boolean", "description": "Fetch each item's detail page for the richer fields. Turn off for the fastest, cheapest runs.", "default": true }, "descriptionFormat": { "title": "📝 Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which representation(s) of the job description to include.", "default": "all" }, "descriptionMaxLength": { "title": "✂️ Description max length", "minimum": 0, "type": "integer", "description": "Truncate each description to at most this many characters. Leave empty (or 0) for the full text — handy for keeping AI-agent payloads small." }, "compact": { "title": "📦 Compact records", "type": "boolean", "description": "Emit only the core fields. Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "🧹 Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-array fields from each record.", "default": false }, "incrementalMode": { "title": "♻️ Incremental mode", "type": "boolean", "description": "Track state between runs and tag every record with a changeType (NEW / UPDATED / UNCHANGED / EXPIRED).", "default": false }, "stateKey": { "title": "🗝️ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "🔁 Include unchanged records", "type": "boolean", "description": "Also emit records that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "🗑️ Include expired records", "type": "boolean", "description": "Emit records for jobs present last run but gone now.", "default": false }, "skipReposts": { "title": "🚫 Skip reposts", "type": "boolean", "description": "In incremental mode, suppress jobs detected as reposts of a previously seen listing (same title + company reappearing under a new id).", "default": false }, "telegramToken": { "title": "💬 Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "🆔 Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "💼 Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "🎮 Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "webhookUrl": { "title": "🪝 Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with the matched records — works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "🧾 Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "whatsappPhoneNumberId": { "title": "📱 WhatsApp phone number ID", "type": "string", "description": "WhatsApp Cloud API phone-number ID (from Meta). Required with the access token and recipient below to send WhatsApp alerts." }, "whatsappAccessToken": { "title": "🔑 WhatsApp access token", "type": "string", "description": "WhatsApp Cloud API access token." }, "whatsappTo": { "title": "📲 WhatsApp recipient", "type": "string", "description": "Recipient phone number in international format, e.g. \"491701234567\"." }, "notificationLimit": { "title": "🔢 Records per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many records to include in each notification message.", "default": 5 }, "notifyOnlyChanges": { "title": "🔀 Notify only on changes", "type": "boolean", "description": "In incremental mode, only send notifications for NEW / UPDATED / REAPPEARED jobs (skip alerts when nothing relevant changed).", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Residential proxies by default — required for full job descriptions and reliable access. Advanced users can switch groups, but residential is recommended for this site.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxRequestRetries": { "title": "🔄 Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed request before giving up on it.", "default": 3 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts API in Python
StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts API in JavaScript
StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts API through CLI
StepStone Job Scraper (DE+AT) | Filters, Descriptions & Alerts API