# 🇩🇪 StepStone Germany Scraper | Jobs & Salaries (`antique_sundew/stepstone-scraper`) Actor

Extract StepStone.de job postings, salary estimates, company details, work locations, and tech stack requirements. Fast German job market scraper API.

- **URL**: https://apify.com/antique\_sundew/stepstone-scraper.md
- **Developed by:** [Alexandru Afanasiuc](https://apify.com/antique_sundew) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 job scrapeds

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## StepStone.de Scraper — Germany Jobs, Locations & Remote Flags

Extract structured job listings from **StepStone.de, Germany's leading job portal**. Search by keyword and city and get clean JSON/CSV with titles, companies, locations, postal codes, posting dates and work-from-home flags.

### Why use this scraper

- **Verified location filter** — a place StepStone does not recognise returns **zero rows**, never the national feed. The guard compares the response against the national feed *and* checks the rows themselves — a nonsense location cannot bill you.
- **Postal codes included** — `postCode` per listing, ready for radius filtering and regional analysis.
- **Remote flags** — hybrid/home-office tags extracted whenever StepStone publishes them.
- **Honest salary field** — StepStone's feed usually sends an empty salary shape pretending to be data; this Actor emits `salary` **only when it contains an actual number**, otherwise `null`. No fake precision.
- **Deduplicated, pure HTTP** — no browser, no repeated rows, fast runs.

### What data you get

```json
{
  "id": "87654321",
  "title": "Elektroniker (m/w/d)",
  "url": "https://www.stepstone.de/stellenangebote--Elektroniker-Muenchen/87654321",
  "textSnippet": "Für unseren Standort München suchen wir...",
  "company": {
    "name": "Example Technik GmbH",
    "logoUrl": "https://www.stepstone.de/upload_de/logo/example.gif",
    "url": "https://www.stepstone.de/cmp/de/example-technik"
  },
  "location": "München",
  "postCode": "80331",
  "datePosted": "2026-08-06",
  "workFromHome": "PARTIALLY_HOME",
  "salary": null,
  "scrapedAt": "2026-08-11T10:00:00.000Z"
}
```

Fields the posting does not include are `null` — this Actor never invents data.

### How to run it

1. Set `keywords` (e.g. `["entwickler"]`, `["pflegekraft"]`, `["buchhalter"]`).
2. Optionally add a `location` (e.g. `"Berlin"`, `"München"`, `"Hamburg"`).
3. Click **Start** and export the dataset as JSON, CSV or Excel.

Works out of the box: the default input (`keywords: ["developer"]`, 100 items) runs successfully with no changes.

### Input parameters

| Field | Type | Default | Description |
|---|---|---|---|
| `keywords` | array | `["developer"]` | Search terms. |
| `location` | string | — | German city or region. |
| `maxItems` | integer | `100` | Cap on returned jobs. |

### Pricing

**$3.00 per 1,000 jobs** (pay per event, no subscription). Examples:

- 100 jobs → **$0.30**
- 500 jobs → **$1.50**
- Zero results (unrecognised keyword or location) → **$0.00**.

### Use cases

- **German market research** — measure hiring volume per city, sector or postal-code region.
- **Job alerts** — schedule daily keyword runs and push new rows to Sheets, Slack or email.
- **Remote-work tracking** — `workFromHome` flags let you measure the remote share of any search.
- **Recruitment lead generation** — `company.url` links straight to employer profiles.
- **AI agents** — call this Actor as a tool through the [Apify MCP server](https://mcp.apify.com/?actors=antique_sundew/stepstone-scraper).

### Limitations

- Returns what the results feed publishes; per-posting page details are out of scope.
- Salary appears only on the minority of listings where StepStone publishes an actual number.
- Germany only — for NL, BE, AT and Totaljobs UK use the [multi-market Actor](https://apify.com/antique_sundew/stepstone-nl-scraper).

### FAQ

**How do I scrape StepStone.de without coding?**
Run this Actor from the Apify Console — set keywords, press Start, export CSV.

**What happens on a typo'd city?**
Zero rows, zero cost. The location guard is verified on both the feed comparison and the row contents.

**Why is `salary` usually null?**
Because StepStone rarely publishes numbers. When the feed sends its usual empty salary shape, this Actor refuses to pass it off as data.

**Can I search all of Germany?**
Yes — leave `location` empty for the national feed.

### Related Actors

- [StepStone NL/BE/AT & Totaljobs UK Scraper](https://apify.com/antique_sundew/stepstone-nl-scraper) — four more markets, one input
- [Reed.co.uk Jobs Scraper](https://apify.com/antique_sundew/reed-uk-jobs-scraper) — the UK's Reed board
- [Pracuj.pl Scraper](https://apify.com/antique_sundew/pracuj-scraper) — Poland's largest job board

***

If this Actor saved you time, a short review on its Store page helps other people find it. If something looks wrong, open an issue on the **Issues** tab — issues get answered.

# Actor input Schema

## `keywords` (type: `array`):

Keywords or search terms to filter job listings (e.g. \['developer', 'engineer', 'marketing']). Leave empty to scrape recent jobs.

## `location` (type: `string`):

Filter by German city name (e.g. 'Berlin', 'München', 'Hamburg', 'Frankfurt').

## `maxItems` (type: `integer`):

Maximum number of job listings to return.

## Actor input object example

```json
{
  "keywords": [
    "developer"
  ],
  "maxItems": 100
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("antique_sundew/stepstone-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("antique_sundew/stepstone-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 '{}' |
apify call antique_sundew/stepstone-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,antique_sundew/stepstone-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 <APIFY_API_TOKEN>` 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/lYnfgy0U9YxniYWXu/builds/sVbQ7epNwSUbrptd5/openapi.json