# StepStone Jobs Scraper - Germany, Full Ads, Contacts, Salary (`centorprat/stepstone-jobs-scraper`) Actor

Scrape StepStone jobs (Germany, Belgium, PNet South Africa) by keyword and location with filters: full ad text, contact email and phone from the ad, salary or StepStone estimate, home office, employment type, industry, agency flag. No login.

- **URL**: https://apify.com/centorprat/stepstone-jobs-scraper.md
- **Developed by:** [Centor Prat](https://apify.com/centorprat) (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

from $0.68 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 - Germany, Full Ads, Contacts, Salary

**Scrape StepStone job listings (stepstone.de, stepstone.be and PNet South Africa) with the full ad and the contact
details written in it.** Search by keyword and location with StepStone's own filters: date posted, home office, full /
part time, contract type, experience, minimum salary, radius and ad language. No login, no browser.

One row per job: title, company, location and postcode, home office (remote / hybrid / on-site), **salary** (employer
posted or **StepStone's salary estimate**, annualized), posted and expiry dates, snippet, benefits, top-job and sponsored
flags, company logo and StepStone company page, plus from the ad page: **full description** (text + HTML), **employment
type**, **industry** (StepStone category), direct-apply flag and the **contact email / phone** the advertiser wrote in the ad.

What we add on top:

- **Contacts from the ad** (`contactEmails`, `contactPhones`) on every row, not as a pricey add-on. `onlyWithContacts` keeps only ads that have them.
- **Agency flag** (`isRecruitmentAgency`): Personaldienstleister / Zeitarbeit / "für unseren Kunden suchen wir" ads. `excludeRecruitmentAgencies` keeps direct employers only.
- **Department**, **seniority class** and **tech stack** mentioned in the ad (Python, SAP, Azure, Salesforce...).
- **Annualized salary** with `source`: `posted` or `stepstone-estimate`.
- `adLanguage: "en"` finds English-language jobs in Germany.

### 📥 Input

| Field | Meaning |
|---|---|
| `keywords` | Searches, e.g. `["data engineer", "Pflegefachkraft"]`; empty = all jobs |
| `country` | `DE` (stepstone.de), `BE` (stepstone.be), `ZA` (pnet.co.za) |
| `locations` | e.g. `["Berlin"]`, `["München"]`, `["Bayern"]`; empty = whole country |
| `maxJobs` | Per keyword x location (up to 5,000) |
| `radius`, `datePosted`, `homeOffice`, `workTypes`, `contractTypes`, `experience`, `minSalary`, `adLanguage`, `sortBy` | StepStone filters |
| `includeDetails` | Open each ad for description, contacts, employment type (default on) |
| `onlyWithContacts`, `excludeRecruitmentAgencies`, `excludeKeywords` | Keep the rows you want |

```json
{ "keywords": ["Pflegefachkraft"], "country": "DE", "locations": ["Hamburg"], "radius": 30, "datePosted": "week", "maxJobs": 200 }
```

### 📤 Output (one job, shortened)

```json
{
  "title": "Pflegedienstleitung (m/w/d)", "company": "Noracare GmbH", "location": "Hamburg", "workplace": "On-site",
  "salary": {"min": 52000, "max": 61000, "period": "year", "currency": "EUR", "annualMin": 52000, "annualMax": 61000, "source": "stepstone-estimate"},
  "postedAt": "2026-10-21T08:12:44Z", "expiresAt": "2026-11-20T08:12:44Z",
  "employmentType": ["FULL_TIME"], "industry": "Gesundheit, Pflege",
  "contactEmails": ["bewerbung@noracare.eu"], "contactPhones": [],
  "isRecruitmentAgency": false, "department": "Operations", "url": "https://www.stepstone.de/stellenangebote--..."
}
```

### 💡 Uses

- **Recruiters / Personalvermittler**: fresh direct-employer roles with the hiring contact.
- **B2B sales in DACH**: who is hiring for what (department, tech stack, industry) = who is about to buy.
- **Salary research**: StepStone's salary estimates across roles and cities.
- **Job alerts and boards**: schedule with `datePosted: "24h"`.

### 💰 Pricing

Pay per job returned (`job` event), full ad and contacts included. Empty searches and filtered-out jobs are free.

### 🤖 API / agents

```bash
curl -X POST "https://api.apify.com/v2/acts/centorprat~stepstone-jobs-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
     -H "Content-Type: application/json" -d '{"keywords": ["SAP Berater"], "locations": ["Frankfurt"], "maxJobs": 20}'
```

MCP: `https://mcp.apify.com/?tools=actors,docs,centorprat/stepstone-jobs-scraper`

### ❓ FAQ

- **Login needed?** No. Public StepStone search and job pages.
- **Where do contacts come from?** Only from what the advertiser wrote in the ad. No candidate or personal profile data.
- **Austria / Netherlands / Totaljobs UK?** Not yet (those sites block automated access); Germany, Belgium and PNet work.

### 🔗 Related actors

- [Company Jobs Scraper](https://apify.com/centorprat/company-hiring-monitor): jobs straight from company career sites.
- [Indeed Jobs Scraper](https://apify.com/centorprat/indeed-jobs-scraper): Indeed in 35 countries with company data.
- [LinkedIn Jobs Scraper](https://apify.com/centorprat/linkedin-jobs-scraper): LinkedIn job listings with full details.

# Actor input Schema

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

Job search keywords, one search per line, e.g. \["data engineer", "Pflegefachkraft"]. Leave empty to list every job in the location.

## `country` (type: `string`):

Which StepStone site to search.

## `locations` (type: `array`):

City or region, e.g. \["Berlin"], \["München"], \["Hamburg"], \["Bayern"]. Empty = the whole country. Each keyword is searched in each location.

## `maxJobs` (type: `integer`):

Up to this many jobs per keyword x location.

## `radius` (type: `integer`):

Include jobs within this distance of the location, e.g. 30.

## `datePosted` (type: `string`):

Only jobs posted in this window.

## `homeOffice` (type: `string`):

StepStone's home-office filter.

## `workTypes` (type: `array`):

Pick one to filter (stepstone.de).

## `contractTypes` (type: `array`):

Keep these contract types.

## `experience` (type: `array`):

Keep these experience levels.

## `minSalary` (type: `integer`):

StepStone's salary filter (annual, EUR / ZAR), e.g. 60000.

## `adLanguage` (type: `string`):

Only ads written in this language (e.g. English-language jobs in Germany).

## `sortBy` (type: `string`):

Order of results.

## `includeDetails` (type: `boolean`):

Open every ad for the full description, employment type, industry and the contact email / phone written in it.

## `onlyWithContacts` (type: `boolean`):

Keep only ads that list a contact email or phone (searches deeper to fill maxJobs). Only kept jobs are charged.

## `excludeRecruitmentAgencies` (type: `boolean`):

Drop ads from staffing / recruitment agencies (Personaldienstleister, Zeitarbeit), keeping direct employers.

## `excludeKeywords` (type: `array`):

Drop jobs whose title or company contains any of these, e.g. \["Werkstudent", "Praktikum"].

## `proxyConfiguration` (type: `object`):

For very large runs: route through Apify Proxy (uses your proxy plan) if StepStone starts rate-limiting.

## Actor input object example

```json
{
  "keywords": [
    "data engineer"
  ],
  "country": "DE",
  "locations": [
    "Berlin"
  ],
  "maxJobs": 10,
  "datePosted": "any",
  "homeOffice": "any",
  "adLanguage": "any",
  "sortBy": "date",
  "includeDetails": true,
  "onlyWithContacts": false,
  "excludeRecruitmentAgencies": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `jobs` (type: `string`):

One row per StepStone job: title, company, location, home office, salary (posted or StepStone estimate, annualized), posted / expiry dates, full description, employment type, industry, contact email/phone from the ad, agency flag, department, tech stack.

# 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 = {
    "keywords": [
        "data engineer"
    ],
    "locations": [
        "Berlin"
    ],
    "maxJobs": 10
};

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

# Prepare the Actor input
run_input = {
    "keywords": ["data engineer"],
    "locations": ["Berlin"],
    "maxJobs": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("centorprat/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 '{
  "keywords": [
    "data engineer"
  ],
  "locations": [
    "Berlin"
  ],
  "maxJobs": 10
}' |
apify call centorprat/stepstone-jobs-scraper --silent --output-dataset

```

## MCP server setup

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