# Stepstone.de Search Jobs by Url or Keywords (`madeingermany/stepstone-search-cheerio-ppr`) Actor High-speed HTTP scraper for Stepstone.de. Extract job postings, salaries, locations, skills, and company profiles with PPE pricing. - **URL**: https://apify.com/madeingermany/stepstone-search-cheerio-ppr.md - **Developed by:** [Made In Germany](https://apify.com/madeingermany) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## StepStone Job Scraper — European Tech & Executive Jobs, Salaries & Direct Apply A high-performance, cost-effective Apify Actor designed to extract comprehensive job postings from **[Stepstone.de](https://www.stepstone.de)** using search keywords, locations, or custom listing URLs. Powered by a **Pure HTTP Fast-Path** architecture with **Crawlee (CheerioCrawler + got-scraping)**, this scraper bypasses client-side browser overhead to deliver up to **10x faster extraction** at a fraction of the computing cost. *** ### 💰 Pricing (Pay-Per-Event) This actor operates on a pay-as-you-go **Pay-Per-Event (PPE)** pricing model. You only pay for what you extract: | Event Name | Purpose | Price (USD) | Description | |---|---|---|---| | **`apify-default-dataset-item`** | result | `$0.001` | Single result in the default dataset. | | **`apify-actor-start`** | Actor Start | `$0.005` | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | | **`additional-data`** | Additional Data | `$0.001` | Charged for additional data | *** ### 🚀 Key Features & Why It Beats Alternatives - **⚡ Blazing Fast HTTP Engine**: Uses direct SSR state extraction (`__PRELOADED_STATE__`) and Cheerio parsing instead of heavy headless browsers (Puppeteer/Playwright). - **💰 Fair Pay-Per-Event (PPE) Pricing**: Pay only for what you extract! Flat $0.005 on actor start + $0.001 per scraped job record. - **🛡️ Built-in Anti-Bot Protection**: Emulates Chrome 130+ TLS fingerprints, browser header generation, and integrates seamlessly with Apify Residential Proxies. - **📊 Rich Structured Data**: Extracts job IDs, titles, company details, locations, salary brackets, employment types, work-from-home policy, posting dates, full direct URLs, benefits, and snippets. - **🔄 Robust Pagination**: Automatically handles pagination across hundreds of result pages up to your configured `maxItems` limit. *** ### 📥 Input Configuration | Parameter | Type | Required | Default | Description | | :--- | :--- | :---: | :--- | :--- | | `startUrls` | Array | No | `["https://www.stepstone.de/jobs/software-engineer/in-munich"]` | Stepstone job search or listing URLs to crawl. | | `searchQuery` | String | No | `"Software Engineer Munich"` | Free-text search terms (e.g. `"Data Analyst Berlin"`). Used if `startUrls` is empty. | | `maxItems` | Integer | No | `50` | Maximum number of job postings to collect (1 to 50,000). | | `scrapeDetails` | Boolean | No | `false` | When enabled, visits individual job posting pages for full description HTML. | | `proxy` | Object | No | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }` | Proxy configuration. Residential proxies are recommended for high-volume jobs. | #### Sample Input JSON ```json { "startUrls": [ { "url": "https://www.stepstone.de/jobs/software-engineer/in-munich" } ], "searchQuery": "Software Engineer Munich", "maxItems": 50, "scrapeDetails": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### 📤 Output Format Each record pushed to the default Apify Dataset contains: | Field | Type | Description | | :--- | :--- | :--- | | `id` | String | Unique Stepstone job identifier | | `title` | String | Job title | | `companyName` | String | Hiring organization / company name | | `companyId` | Number/String | Company ID on Stepstone | | `companyUrl` | String | Link to company profile on Stepstone | | `companyLogoUrl` | String | URL of the company logo | | `location` | String | City, region, or locations list | | `salary` | String/Null | Salary estimate or disclosed range (e.g., `"60,000 - 75,000 EUR / year"`) | | `jobType` | String | Employment type (e.g., `Full-time`, `Part-time`, `Working Student`) | | `postingDate` | String | ISO 8601 publication timestamp | | `directUrl` | String | Canonical job offer link | | `workFromHome` | String/Null | Remote status (`Hybrid`, `Remote`, `On-site`) | | `textSnippet` | String/Null | Short summary or introduction snippet | | `skills` | Array | Required skills and technologies | | `jobBenefits` | Array | Listed perks and benefits | | `isSponsored` | Boolean | Indicates if job listing is sponsored | | `isTopJob` | Boolean | Indicates if job is a featured Top Job | | `sourceUrl` | String | Listing URL where the job was discovered | | `scrapedAt` | String | ISO 8601 scraping timestamp | #### Sample Output Record ```json { "id": "14537081", "title": "Software Engineer Java (all genders)", "companyName": "adesso insurance solutions GmbH", "companyId": 153720, "companyUrl": "https://www.stepstone.de/cmp/de/adesso-insurance-solutions-gmbh-153720/jobs", "companyLogoUrl": "https://www.stepstone.de/upload_DE/logo/A/logoadesso-insurance-solutions-GmbH-153720DE.gif", "location": "Berlin, Hamburg, München, Köln, Frankfurt, Stuttgart, Leipzig, Dortmund", "salary": "65,000 - 80,000 EUR / year", "jobType": "Full-time", "postingDate": "2026-09-24T05:27:26+02:00", "directUrl": "https://www.stepstone.de/stellenangebote--Software-Engineer-Java-all-genders-Berlin-Hamburg-Muenchen-Koeln-Frankfurt-Stuttgart-Leipzig-Dortmund-adesso-insurance-solutions-GmbH--14537081-inline.html", "workFromHome": "Hybrid (Partial Home Office)", "textSnippet": "Als Teil der adesso group bündelt die adesso insurance solutions GmbH das eigene Produktportfolio für den Versicherungsmarkt...", "skills": ["Java", "Spring Boot", "Docker"], "jobBenefits": [ "Bleib gesund und fit: Sportzuschüsse und Gesundheitstage", "Finde deine Work-Life-Balance: Flexible Arbeitsmodelle und mobiles Arbeiten", "Lerne und wachse mit uns: Weiterbildungsbudget und Schulungen" ], "isSponsored": false, "isTopJob": false, "sourceUrl": "https://www.stepstone.de/jobs/software-engineer/in-munich", "scrapedAt": "2026-09-28T02:44:03.456Z" } ``` *** ### 🏷️ Tags & Categories `stepstone`, `job-scraper`, `germany-jobs`, `recruitment`, `career`, `hiring`, `cheerio`, `fast-path`, `pay-per-event`, `hr-analytics` # Actor input Schema ## `startUrls` (type: `array`): Stepstone.de job search or listing URLs to scrape. ## `searchQuery` (type: `string`): Free-text job search keywords and/or location (e.g. 'Software Engineer Munich'). Used when startUrls is empty or in addition. ## `maxItems` (type: `integer`): Maximum number of jobs to extract across all search pages. ## `scrapeDetails` (type: `boolean`): If enabled, visits each individual job listing page to extract full HTML descriptions and Schema.org metadata. ## `proxy` (type: `object`): Select Apify Proxy (Residential recommended) or custom proxies. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.stepstone.de/jobs/software-engineer/in-munich" } ], "searchQuery": "Software Engineer Munich", "maxItems": 50, "scrapeDetails": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.stepstone.de/jobs/software-engineer/in-munich" } ], "searchQuery": "Software Engineer Munich" }; // Run the Actor and wait for it to finish const run = await client.actor("madeingermany/stepstone-search-cheerio-ppr").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.stepstone.de/jobs/software-engineer/in-munich" }], "searchQuery": "Software Engineer Munich", } # Run the Actor and wait for it to finish run = client.actor("madeingermany/stepstone-search-cheerio-ppr").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.stepstone.de/jobs/software-engineer/in-munich" } ], "searchQuery": "Software Engineer Munich" }' | apify call madeingermany/stepstone-search-cheerio-ppr --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,madeingermany/stepstone-search-cheerio-ppr" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/zUt9paeZOE5h4aLvQ/builds/MrZAKatJ2JpEiLgB7/openapi.json