# Stellenanzeigen.de Scraper — German Jobs with Salary (`hipersoft/stellenanzeigen-scraper`) Actor

Scrape job ads from stellenanzeigen.de, a major German job portal: title, company, location with ZIP, state and coordinates, employment type, home office, benefits, salary range, application email, posting and expiry dates, logo. Keyword and city search. Export CSV/JSON.

- **URL**: https://apify.com/hipersoft/stellenanzeigen-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00125 / job

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

## Stellenanzeigen.de Scraper: German Jobs with Salary, Location and Benefits

**Stellenanzeigen.de Scraper** extracts job ads from **stellenanzeigen.de**, one of Germany's established job portals with thousands of current vacancies in **IT, healthcare and nursing (Pflege), sales, engineering, finance, crafts and trades**. For every job you get the **title, company, short summary, location with ZIP code, federal state and coordinates, employment type (Vollzeit, Teilzeit, Minijob, Ausbildung, Werkstudent…), home office and benefits, salary range with period, top-job and quick-apply flags, application email or link, posting date, first publication date, expiry date and company logo**. Search any **job title or keyword**, limit to a **German city**, and export to **CSV, Excel or JSON**. Ideal for **recruiting, salary benchmarking and German labour-market research**.

### What does Stellenanzeigen.de Scraper do?

- 🔎 **Keyword search**: Entwickler, Pflege, Vertrieb, Buchhaltung, Elektriker, Erzieher…
- 🏙️ **City filter**: Berlin, München, Hamburg, Köln, Frankfurt and any German city (with surroundings).
- 💶 **Salary**: minimum, maximum, currency and period (year, month, hour) where published.
- 🕒 **Employment type**: Vollzeit, Teilzeit, Minijob, Ausbildung, Werkstudent, Praktikum, Homeoffice.
- 🎁 **Benefits** as listed (flexible hours, training, health offers, childcare…).
- 📍 **Location** with ZIP, federal state and GPS coordinates; extra locations for multi-site jobs.
- 📧 **Application email or link**.
- 📅 **Posted, first published and expiry dates**.
- ⭐ **Top job** and **quick apply** flags.
- 🖼️ **Company logo**.
- 🔗 **Paste search links** with your own filters.

### What data can you scrape from stellenanzeigen.de?

| Field | Description |
|---|---|
| Job | ID, title, link, summary |
| Company | Name, logo |
| Location | City, ZIP, state, country, latitude, longitude, other locations |
| Type | Employment types, benefits |
| Salary | Min, max, currency, period, salary text |
| Flags | Top job, quick apply |
| Apply | Application email or link |
| Dates | Posted, first published, expires |

### Use cases for German job data

- **Recruiters and staffing agencies**: find open roles and hiring companies by city and profession.
- **Salary benchmarking**: compare published salary ranges for German jobs.
- **Labour-market research**: track demand for nurses, developers and skilled trades.
- **HR tech and job aggregators**: syndicate German vacancies.
- **Sales teams**: identify companies that are hiring and growing.
- **Job seekers**: build alerts for new roles in your city.

### How to scrape stellenanzeigen.de

1. Click **Try for free** to open the scraper in Apify Console.
2. Enter **job titles or keywords** and optionally a **city**.
3. Optionally turn on **Only jobs with salary**.
4. Set **Max jobs** and click **Start**.
5. Download the jobs as **CSV, Excel or JSON**.

### Input

#### Example input

```json
{
  "searchTerms": ["Pflege", "Backend Entwickler"],
  "location": "München",
  "withSalaryOnly": false,
  "maxItems": 500
}
```

| Field | Description |
|---|---|
| **Job titles or keywords** | One search per term. |
| **City** | Optional German city (with surroundings). |
| **Search links** | stellenanzeigen.de search links with your own filters. |
| **Only jobs with salary** | Only jobs that publish a salary. |
| **Max jobs** | Stop after this many (0 = no limit). |

### Output

#### Job example

```json
{
  "jobId": "SDE-118389",
  "url": "https://www.stellenanzeigen.de/job/backend-development-m-w-d-moenchengladbach-sde-118389/",
  "title": "Backend Development (m/w/d)",
  "company": "Keoz GmbH",
  "summary": "Gestalte innovative Backend-Lösungen bei KEOZ GmbH! Wir suchen einen Backend Developer (m/w/d) mit Erfahrung in Node.js und Microservices…",
  "location": "Mönchengladbach",
  "state": "Nordrhein-Westfalen",
  "zip": "41061",
  "country": "Deutschland",
  "latitude": 51.19447,
  "longitude": 6.43161,
  "employmentType": ["Vollzeit"],
  "benefits": ["Gesundheitsangebote", "Weiterbildungsangebote", "Flexible Arbeitszeiten"],
  "salaryMin": 60000,
  "salaryMax": 85000,
  "salaryCurrency": "EUR",
  "salaryPeriod": "year",
  "salaryText": "60.000 - 85.000 €/Jahr",
  "topJob": true,
  "quickApply": true,
  "applicationEmail": "jobs@keoz.com",
  "postedAt": "2026-10-07",
  "firstPublishedAt": "2026-09-02",
  "expiresAt": "2026-11-01",
  "companyLogo": "https://dxl6houvklhzf.cloudfront.net/public/jobs/SDE-118389/company_logo/logo.jpg_1.png",
  "search": "Backend Entwickler"
}
```

#### Output schema

| Field | Type | Description |
|---|---|---|
| `jobId`, `url`, `title`, `summary` | string | Job. |
| `company`, `companyLogo` | string | Employer. |
| `location`, `state`, `zip`, `country`, `latitude`, `longitude`, `otherLocations` | mixed | Location. |
| `employmentType`, `benefits` | array | Type and benefits. |
| `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod`, `salaryText` | mixed | Salary. |
| `topJob`, `quickApply` | boolean | Flags. |
| `applicationEmail` | string | Application email or link. |
| `postedAt`, `firstPublishedAt`, `expiresAt` | string | Dates. |
| `search`, `scrapedAt` | string | Source info. |

### How much does it cost?

The scraper uses **pay-per-job** pricing: a small fixed price per job, with automatic discounts on higher Apify plans. See the **Pricing** tab for the exact price.

### More job data

- [Arbeitsagentur Jobs Scraper](https://apify.com/hipersoft/arbeitsagentur-jobs-scraper): jobs from the German Federal Employment Agency.
- [LinkedIn Jobs Scraper](https://apify.com/hipersoft/linkedin-jobs-scraper): jobs worldwide.
- [Indeed Scraper](https://apify.com/hipersoft/indeed-scraper): Indeed job listings.

### FAQ

**Do all jobs show a salary?**
No. Turn on **Only jobs with salary** to keep only jobs that publish one.

**Can I search a specific city?**
Yes. Enter a German city in **City**; nearby towns are included.

**What formats can I export?**
CSV, Excel, JSON, XML, HTML and RSS, or read the results through the Apify API.

**Can I integrate this scraper with other apps?**
The scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JS/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

**Is it legal to scrape stellenanzeigen.de?**
The scraper only collects publicly posted job ads. You are responsible for using the data in line with the site's terms and GDPR.

### Related Actors

- [Arbeitsagentur Jobs Scraper](https://apify.com/hipersoft/arbeitsagentur-jobs-scraper)
- [LinkedIn Jobs Scraper](https://apify.com/hipersoft/linkedin-jobs-scraper)

### Notes

Original clean-room implementation. Returns only public data. Not affiliated with stellenanzeigen.de.

# Actor input Schema

## `searchTerms` (type: `array`):

What to search, e.g. Entwickler, Pflege, Vertrieb, Buchhaltung, Elektriker. Each term is a separate search.

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

Optional German city, e.g. Berlin, München, Hamburg, Köln. Leave empty for all of Germany.

## `startUrls` (type: `array`):

Optional. Paste stellenanzeigen.de search links with your own filters.

## `withSalaryOnly` (type: `boolean`):

Only return jobs that publish a salary.

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

Stop after this many jobs. 0 means no limit.

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

Not required for normal use.

## Actor input object example

```json
{
  "searchTerms": [
    "Pflege"
  ],
  "location": "Berlin",
  "withSalaryOnly": false,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

The results as dataset items.

# 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 = {
    "searchTerms": [
        "Pflege"
    ],
    "location": "Berlin",
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/stellenanzeigen-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 = {
    "searchTerms": ["Pflege"],
    "location": "Berlin",
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/stellenanzeigen-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 '{
  "searchTerms": [
    "Pflege"
  ],
  "location": "Berlin",
  "maxItems": 50
}' |
apify call hipersoft/stellenanzeigen-scraper --silent --output-dataset

```

## MCP server setup

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