# StepStone Jobs Scraper (`robertosan16/stepstone-jobs-scraper`) Actor Scrape StepStone.de jobs in Germany by keyword and city: title, company, location, remote, contract type, full description, benefits, industry and apply link. All StepStone filters and alerts. - **URL**: https://apify.com/robertosan16/stepstone-jobs-scraper.md - **Developed by:** [Robert Khairislamov](https://apify.com/robertosan16) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.50 / 1,000 jobs 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 Jobs Scraper **Scrape StepStone.de jobs in Germany by keyword and city.** Get title, company, location, home office, contract type, full description, benefits, industry and apply link. Export to JSON, CSV or Excel, or use the API. **$0.50 per 1,000 jobs, no start fee.** Scrape jobs from **StepStone** (`stepstone.de`), one of Germany's biggest job sites, the way you search on the website: keywords, city and distance, and the StepStone filters for contract type, working hours, home office, experience and the language of the job ad. Each job comes with the company, all locations, home office status, employment type, **benefits as a list**, industry, the full description, the posting and expiry dates and the job link. Every page of a search is read, so you **get all matching jobs**. Run it on a schedule to get **only new jobs**. No browser, no login. ### What can this StepStone scraper do? - 🔎 **Search like on the website**: keywords such as `Softwareentwickler`, `data analyst` or `Pflege`, a city and a distance, or paste any stepstone.de search link. - 🎛️ **StepStone filters**: contract type (permanent, fixed-term, freelance, working student, internship, apprenticeship and more), full-time or part-time, home office (partly or fully remote), experience, and jobs posted in the last 7 days. - 🇬🇧 **English-language jobs**: pick English as the job ad language to find jobs in Germany where English is enough. - ♾️ **All results**: every page of a search, thousands of jobs per run, without duplicates. - 🎁 **Benefits as a list**: company car, flexible hours, pension plan, JobRad and more, as StepStone shows them. - 🧾 **Full job details**: description as text and HTML, employment type, industry, expiry date, quick apply and "no cover letter needed" flags. - 🆕 **Only new jobs since the last run**: for job alerts, recruiting pipelines and market monitoring. - 🧩 **Same output as our other job scrapers**, listed at the end of this page, so jobs from company career sites and job boards fit into one table. ### What data does it extract? | Field | Example | |---|---| | `title` | Software Engineer Python - GenAI, LLM & Agentic Systems (m/w/d) | | `companyName` / `company` | Vonovia / 76597 | | `location` / `locations` | Bochum | | `remote` / `workplaceType` | false / hybrid | | `employmentType` | full-time | | `benefits` | Unbefristetes Arbeitsverhältnis, mobiles Arbeiten, Jobrad, … | | `industry` | IT, IT-Softwareentwicklung | | `quickApply` / `noCoverLetter` | true / false | | `postedAt` / `validThrough` | 2026-09-25 / 2026-10-25 | | `jobUrl` | https://www.stepstone.de/stellenangebote--…-14430443-inline.html | | `descriptionText` / `descriptionHtml` | full job description | | `salary` | as numbers when the job states it | ### How to scrape StepStone jobs 1. Enter **job titles or keywords**, one search per line, for example `data analyst`. Or paste links of searches you made on stepstone.de. 2. Optionally set a **location** such as `Berlin` or `München` and a **distance**. 3. Optionally pick **contract types**, **working hours**, **home office**, **experience**, the **job ad language** or a **date range**. 4. Click **Start**. Download the jobs as JSON, CSV, Excel or HTML, or get them through the API. #### Example input ```json { "searchQueries": ["data analyst", "python developer"], "location": "Berlin", "radius": 30, "contractTypes": ["222"], "remoteTypes": ["2", "1"], "languages": ["en"], "postedWithinDays": 7 } ``` Contract type `222` is a permanent contract; home office `2` is partly and `1` fully remote. In the form you simply pick them from lists. #### Example output ```json { "ats": "stepstone", "company": "76597", "companyName": "Vonovia", "jobId": "14430443", "title": "Software Engineer Python - GenAI, LLM & Agentic Systems (m/w/d)", "location": "Bochum", "locations": ["Bochum"], "remote": false, "workplaceType": "hybrid", "employmentType": "full-time", "salary": null, "postedAt": "2026-09-25T08:12:31.000Z", "jobUrl": "https://www.stepstone.de/stellenangebote--Software-Engineer-Python-GenAI-LLM-Agentic-Systems-m-w-d-Bochum-Vonovia--14430443-inline.html", "applyUrl": "https://www.stepstone.de/stellenangebote--Software-Engineer-Python-GenAI-LLM-Agentic-Systems-m-w-d-Bochum-Vonovia--14430443-inline.html", "descriptionText": "Einleitung\n\nAls Teil des Wohnungskonzerns Vonovia SE gestalten unsere kaufmännischen Teams den Alltag für über eine Million Mieter:innen…", "descriptionHtml": "

Einleitung

\n

Als Teil des Wohnungskonzerns Vonovia SE…", "benefits": [ "Sicherheit: Du arbeitest in einem unbefristeten Arbeitsverhältnis in einem dynamisch wachsenden Unternehmen", "Flexibilität & Weiterbildung: Arbeiten aus dem Homeoffice heraus? Wir bieten mobiles Arbeiten mit flexiblen Arbeitszeiten…", "Gesundheit: Angebote zur Mitarbeiter:innengesundheit z.B. vergünstigte Fitnessstudiobeiträge, Grippeschutzimpfung, Jobrad (auch E-Bike), etc." ], "skills": null, "industry": "IT, IT-Softwareentwicklung", "quickApply": true, "noCoverLetter": false, "validThrough": "2026-10-25T09:12:31.12Z", "companyUrl": "https://www.stepstone.de/cmp/de/vonovia-76597/jobs", "companyLogoUrl": "https://www.stepstone.de/upload_DE/logo/V/logoVonovia-76597DE.gif", "scrapedAt": "2026-09-25T17:25:46.737Z" } ``` ### Use cases - **Recruitment agencies and staffing firms**: see every new job for your specialty and region each morning. - **Job boards and aggregators**: fill a German or English-language job board with fresh StepStone listings. - **Sales and lead generation**: companies hiring for a function are buying tools and services for it. Turn job ads into leads. - **Labor market research**: track demand by city, industry, contract type and home office share. - **Relocation and expat services**: collect English-language jobs in Germany. ### How much does it cost? You pay only for the jobs you get: **$0.50 per 1,000 jobs**. There is no start fee. Jobs filtered out by your settings are free. The Apify free plan covers about 10,000 jobs every month. ### Tips - **Daily job alerts**: save your input as a task, turn on **Only new jobs since the last run** and add a schedule. Send new jobs to Slack, email or Google Sheets with Apify integrations. - **Fast lists**: turn off **Load full job details** to skip the job pages. You still get title, company, locations, home office, date, benefits and a short summary. - **Stricter results**: StepStone also matches related words. Use **Title must contain** to keep only jobs with your keyword in the title. - **German city names** work with or without umlauts: `München` or `Muenchen`. - **Errors per search**: see the `SUMMARY` record in the run's key-value store. ### FAQ **Why do most jobs have no salary?** Most German employers do not publish pay, and StepStone shows its salary estimates only to logged-in visitors. When a job states pay in its data or description, it is saved as numbers. **Does it collect recruiter contact details?** No. There are no fields for recruiters' names, emails or phone numbers, and they are not requested. The job description is saved as the employer wrote it. **Is it legal to scrape StepStone?** The Actor reads the public job listings StepStone shows to every visitor. Check the terms that apply to your use case. ### More job scrapers with the same output - [Greenhouse Jobs Scraper](https://apify.com/robertosan16/greenhouse-jobs-scraper): every job of any company on Greenhouse, with salary ranges - [Lever Jobs Scraper](https://apify.com/robertosan16/lever-jobs-scraper): every job of any company on Lever, including EU sites - [Ashby Jobs Scraper](https://apify.com/robertosan16/ashby-jobs-scraper): startup jobs from Ashby job boards, with compensation - [Workday Jobs Scraper](https://apify.com/robertosan16/workday-jobs-scraper): every job from any Workday career site, past the 2,000 search limit - [Dice Jobs Scraper](https://apify.com/robertosan16/dice-jobs-scraper): US tech jobs from Dice.com, with skills and salaries - [Welcome to the Jungle Jobs Scraper](https://apify.com/robertosan16/welcome-to-the-jungle-jobs-scraper): startup jobs in France, Europe, the UK and the US - [SEEK Jobs Scraper](https://apify.com/robertosan16/seek-jobs-scraper): jobs in Australia and New Zealand, with salaries as numbers Missing a field or a feature? Open an issue in the Issues tab and we will reply quickly. # Actor input Schema ## `searchQueries` (type: `array`): What to search, for example Softwareentwickler, data analyst or Pflege. Each line is a separate search with the filters below. You can also paste links of searches from stepstone.de. ## `location` (type: `string`): A city or region, for example Berlin, München or Frankfurt am Main. Leave empty for all of Germany. ## `radius` (type: `integer`): Also find jobs this far from the location, for example 30. ## `contractTypes` (type: `array`): Leave empty for all. ## `workTypes` (type: `array`): Leave empty for all. ## `remoteTypes` (type: `array`): Leave empty for all jobs, including on-site ones. ## `experience` (type: `array`): Leave empty for all. ## `languages` (type: `array`): Only jobs written in these languages. Pick English for jobs where English is enough. ## `postedWithinDays` (type: `integer`): Keep jobs published in the last N days: 1 means today and yesterday. Leave empty or 0 for any date. ## `sortBy` (type: `string`): Newest first suits job alerts. Links you paste keep their own order. ## `excludeKeywords` (type: `array`): Skip jobs whose title contains any of these, for example intern or senior. Common word endings are included. ## `keywords` (type: `array`): Keep only jobs whose title contains any of these words or phrases. StepStone searches descriptions too, so this makes results stricter. Add * for any ending: data*. ## `onlyWithSalary` (type: `boolean`): Keep only jobs that state a pay range or rate. ## `onlyNew` (type: `boolean`): For scheduled runs: save only jobs that were not seen in earlier runs of the same saved task. The first run saves all current jobs and remembers them. Jobs that did not match your filters are remembered too. ## `includeDescription` (type: `boolean`): Open each job page for the full description (text and HTML), employment type, industry and expiry date. Turn off for fast results with a short summary instead. ## `maxItems` (type: `integer`): Stop after saving this many jobs. Leave empty or 0 for no limit. The example is kept small so the first run takes seconds. ## `maxItemsPerCompany` (type: `integer`): Save at most this many jobs from each search. Leave empty or 0 for no limit. ## `proxyConfiguration` (type: `object`): The Actor connects directly, which is fastest. If StepStone starts limiting requests, it switches to Apify Proxy automatically. Turn on a proxy here only to use it from the start. ## Actor input object example ```json { "searchQueries": [ "python developer" ], "sortBy": "date", "onlyWithSalary": false, "onlyNew": false, "includeDescription": true, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `jobs` (type: `string`): Job postings with title, company, locations, salary, dates, description and links. ## `summary` (type: `string`): Jobs found, matched and saved for each company, with errors. # 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 = { "searchQueries": [ "python developer" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("robertosan16/stepstone-jobs-scraper").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 = { "searchQueries": ["python developer"], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("robertosan16/stepstone-jobs-scraper").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 '{ "searchQueries": [ "python developer" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } }' | apify call robertosan16/stepstone-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,robertosan16/stepstone-jobs-scraper" } } } ``` 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/iY2HrdYLxAM58624E/builds/WFCaWlqKLnQ6MnNhg/openapi.json