# meinestadt.de Jobs Scraper - German Job Listings (`studio-amba/meinestadt-scraper`) Actor
Scrape German job listings from jobs.meinestadt.de: titles, companies, locations, work time, estimated salaries and posting dates. Optional detail fetch adds full job descriptions and validity dates.
- **URL**: https://apify.com/studio-amba/meinestadt-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 result 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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use 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
### What does meinestadt.de Scraper do?
**meinestadt.de Scraper** extracts job listings from [jobs.meinestadt.de](https://jobs.meinestadt.de) — a German local-city job board covering thousands of towns and cities across Germany. It collects **job titles, companies, locations, work time, posting dates, and estimated salaries** for any keyword and city. An optional detail mode adds the **full job description, structured salary range, and posting expiry date**. No login or cookies required.
Use the Apify platform to run this scraper on a schedule, access results via API, or integrate with tools like Google Sheets, Slack, Zapier, and Make.
### Why use meinestadt.de Scraper?
- **Market research** — Track job availability and salary ranges for a role across German cities
- **Recruitment intelligence** — Monitor which companies are hiring, in which cities, and at what pay
- **Salary benchmarking** — meinestadt.de shows a site-estimated salary range on most listings, useful for comparing pay across regions
- **Lead generation** — Collect hiring-company data for recruitment agencies or HR tech outreach
- **Labor market analysis** — Aggregate job counts and salary bands by city, keyword, or industry
- **Aggregation** — Combine with other German job boards (arbeitsagentur, stepstone, jobware) for fuller market coverage
### How to scrape meinestadt.de jobs data
1. Go to the [meinestadt.de Scraper](https://apify.com/studio-amba/meinestadt-scraper) page on Apify
2. Click **Try for free** to open the actor in Apify Console
3. Enter a German keyword (e.g. "Krankenpfleger", "Elektriker", "Verkäufer")
4. Enter a city slug (e.g. "berlin", "muenchen", "koeln") — or "deutschland" for a nationwide search
5. Optionally set a search radius in kilometers
6. Optionally enable **Fetch full job details** for the full description, structured salary, and expiry date
7. Set the maximum number of results you need (up to 1,000 per query — the site's own cap)
8. Click **Start** and wait for the scraper to finish
9. Download your data in JSON, CSV, Excel, or HTML format
### Input
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | German job keyword (default: "Krankenpfleger"). Examples: "Elektriker", "Verkäufer", "Lagerhelfer" |
| `citySlug` | String | No | City URL slug, lowercase with umlauts transliterated and hyphens (default: "berlin"). Examples: "muenchen", "koeln", "bergisch-gladbach". Use "deutschland" for a nationwide search |
| `radius` | Integer | No | Search radius around the city in kilometers (site's "umkreis" parameter). Leave empty for the site default |
| `fetchDetails` | Boolean | No | Fetch each job's detail page for the full description, structured salary, and validity date. Costs one extra HTTP request per job (default: false) |
| `maxResults` | Integer | No | Maximum job listings to return (default: 20). The site caps any single query at 1,000 results — use a narrower city, keyword, or radius to go beyond that |
| `proxyConfiguration` | Object | No | Proxy settings. **Residential proxies targeting Germany are required** — see Limitations below |
### Output
Each job listing contains:
| Field | Type | Example |
|-------|------|---------|
| `jobTitle` | String | `"Pflegefachkraft (m/w/d)"` |
| `company` | String | `"Krankenhaus Waldfriede e. V."` |
| `location` | String | `"Berlin"` |
| `date` | String | `"12.07.2026"` |
| `workTime` | String | `"Vollzeit oder Teilzeit"` |
| `salary` | String | `"38.300 € - 49.000 €/Jahr (geschätzt)"` |
| `salaryEstimated` | Boolean | `true` |
| `url` | String | Full job detail URL on meinestadt.de |
| `jobDescription` | String | Full job description (fetchDetails only) |
| `salaryMin` | Number | `38316` (fetchDetails only) |
| `salaryMax` | Number | `48995` (fetchDetails only) |
| `validThrough` | String | `"2026-08-20"` (fetchDetails only) |
| `scrapedAt` | String | `"2026-07-12T22:37:52.139Z"` |
### Example output
```json
{
"jobTitle": "Pflegefachkraft oder Gesundheits- und Krankenpfleger/in (m/w/d)",
"company": "Krankenhaus Waldfriede e. V. Akademisches Lehrkrankenhaus der Charité",
"location": "Berlin",
"date": "12.07.2026",
"workTime": "Vollzeit oder Teilzeit",
"salary": "38.300 € - 49.000 €/Jahr (geschätzt)",
"salaryEstimated": true,
"url": "https://jobs.meinestadt.de/berlin/premium?id=100012771570",
"jobDescription": "\n - Ganzheitliche, professionelle Pflege unserer Patient/innen
\n...
",
"salaryMin": 38316,
"salaryMax": 48995,
"validThrough": "2026-08-20",
"scrapedAt": "2026-07-12T22:37:52.139Z"
}
````
### How much does it cost to scrape meinestadt.de?
Listing-only runs are cheap — one search-page request returns 20 jobs. Detail mode adds one request per job.
- **~20 listings** (no details): ~1 request, well under 0.1 compute units
- **~100 listings** (no details): ~5 requests, ~0.1 compute units
- **~100 listings with full details**: ~105 requests, ~0.3-0.5 compute units
- **~1,000 listings** (the site's per-query cap), no details: ~50 requests, ~0.3 compute units
Costs vary with proxy usage — this actor requires residential proxies (see below), which cost more per request than datacenter proxies but are the only reliable option here.
### Limitations
- **Requires residential proxies targeting Germany.** jobs.meinestadt.de runs Akamai Bot Manager, which blocks by TLS fingerprint rather than IP. Datacenter proxies get connection resets on a large share of requests, and there is no German datacenter proxy pool available — residential/DE is preconfigured as the default and should not be changed.
- **1,000 results per query.** This is a hard cap on the site itself (page 51 returns a 404), not a scraper limitation. Split large harvests by city, keyword, or radius to go beyond it.
- **Salary is usually site-estimated**, not employer-stated — check `salaryEstimated` before treating it as authoritative.
- Not every listing has a work-time or salary chip — these fields are `null` when meinestadt.de doesn't show them.
- Data is scraped from the public website and may change without notice.
### FAQ and support
**Is it legal to scrape meinestadt.de?**
This actor extracts publicly available data from jobs.meinestadt.de. Users are responsible for ensuring their use complies with applicable laws and the website's terms of service.
**Why do I need a residential proxy?**
jobs.meinestadt.de's anti-bot system (Akamai Bot Manager) fingerprints the TLS handshake, not just the IP. Datacenter IPs get their connections reset on detail pages roughly half the time. Residential proxies scoped to Germany avoid this reliably.
**The scraper returned 0 results?**
Check that `citySlug` is a valid meinestadt.de city slug (lowercase, umlauts transliterated: "muenchen" not "münchen") and that `searchQuery` has real results for that city. Also confirm the proxy configuration is genuinely RESIDENTIAL with country DE.
**Can I search all of Germany at once?**
Yes — set `citySlug` to `"deutschland"` for a nationwide search across all cities.
**Need this data on a schedule, or a custom version?**
We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API — maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.
See [studioamba.dev/services](https://studioamba.dev/services/) or email
for a free data sample.
We maintain 300+ European web scrapers and answer within one business day.
### Related Scrapers
Looking for more German job market data? We also maintain scrapers for:
- **Arbeitsagentur Scraper** — Germany's federal job agency listings
- **StepStone Scraper** — one of Germany's largest job boards
- **Jobware Scraper** — German B2B and skilled-trades job board
- **Eures Scraper** — EU-wide job mobility portal, including German listings
# Actor input Schema
## `searchQuery` (type: `string`):
Job keyword to search for, in German, e.g. 'Krankenpfleger', 'Elektriker', 'Verkäufer'.
## `citySlug` (type: `string`):
City to search in, as a URL slug (lowercase, umlauts transliterated, hyphenated), e.g. 'berlin', 'muenchen', 'koeln'. Use 'deutschland' for a nationwide search.
## `radius` (type: `integer`):
Optional search radius around the city in kilometers (maps to the site's 'umkreis' parameter). Leave empty for the site default.
## `fetchDetails` (type: `boolean`):
Fetch each job's detail page for the full HTML description, validThrough date and structured salary. Costs ONE EXTRA HTTP request per job on top of the search-page walk — with up to 1,000 results per query this can meaningfully increase run time. Leave off for a fast listing-only crawl.
## `maxResults` (type: `integer`):
Maximum number of job listings to return. The site caps any single search query at 1,000 results (50 pages of 20) — use a narrower city/keyword/radius to go beyond that.
## `proxyConfiguration` (type: `object`):
meinestadt.de's Akamai Bot Manager blocks by TLS fingerprint. Datacenter proxies get reset mid-crawl (NGHTTP2 errors) and there is no German datacenter pool on this account — RESIDENTIAL with country DE is required for a reliable crawl.
## Actor input object example
```json
{
"searchQuery": "Krankenpfleger",
"citySlug": "berlin",
"fetchDetails": false,
"maxResults": 20,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
}
```
# 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 = {
"searchQuery": "Krankenpfleger",
"citySlug": "berlin",
"maxResults": 20,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/meinestadt-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 = {
"searchQuery": "Krankenpfleger",
"citySlug": "berlin",
"maxResults": 20,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "DE",
},
}
# Run the Actor and wait for it to finish
run = client.actor("studio-amba/meinestadt-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"searchQuery": "Krankenpfleger",
"citySlug": "berlin",
"maxResults": 20,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
}' |
apify call studio-amba/meinestadt-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=studio-amba/meinestadt-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "meinestadt.de Jobs Scraper - German Job Listings",
"description": "Scrape German job listings from jobs.meinestadt.de: titles, companies, locations, work time, estimated salaries and posting dates. Optional detail fetch adds full job descriptions and validity dates.",
"version": "0.1",
"x-build-id": "Vfru9TSnpLoY9Nxql"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/studio-amba~meinestadt-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-studio-amba-meinestadt-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/studio-amba~meinestadt-scraper/runs": {
"post": {
"operationId": "runs-sync-studio-amba-meinestadt-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/studio-amba~meinestadt-scraper/run-sync": {
"post": {
"operationId": "run-sync-studio-amba-meinestadt-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchQuery": {
"title": "Search Keyword",
"type": "string",
"description": "Job keyword to search for, in German, e.g. 'Krankenpfleger', 'Elektriker', 'Verkäufer'.",
"default": "Krankenpfleger"
},
"citySlug": {
"title": "City Slug",
"type": "string",
"description": "City to search in, as a URL slug (lowercase, umlauts transliterated, hyphenated), e.g. 'berlin', 'muenchen', 'koeln'. Use 'deutschland' for a nationwide search.",
"default": "berlin"
},
"radius": {
"title": "Radius (km)",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Optional search radius around the city in kilometers (maps to the site's 'umkreis' parameter). Leave empty for the site default."
},
"fetchDetails": {
"title": "Fetch full job details",
"type": "boolean",
"description": "Fetch each job's detail page for the full HTML description, validThrough date and structured salary. Costs ONE EXTRA HTTP request per job on top of the search-page walk — with up to 1,000 results per query this can meaningfully increase run time. Leave off for a fast listing-only crawl.",
"default": false
},
"maxResults": {
"title": "Max Results",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum number of job listings to return. The site caps any single search query at 1,000 results (50 pages of 20) — use a narrower city/keyword/radius to go beyond that.",
"default": 20
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "meinestadt.de's Akamai Bot Manager blocks by TLS fingerprint. Datacenter proxies get reset mid-crawl (NGHTTP2 errors) and there is no German datacenter pool on this account — RESIDENTIAL with country DE is required for a reliable crawl."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```