# Meinestadt Jobs Details Scraper (`alexist/meinestadt-jobs-details-scraper`) Actor Scrape detailed job postings from Meinestadt.de, Germany's leading job portal. Extract titles, descriptions, salary ranges, company info, employment types, skills, and benefits — perfect for HR analytics, market research, and job board aggregation. - **URL**: https://apify.com/alexist/meinestadt-jobs-details-scraper.md - **Developed by:** [Alex](https://apify.com/alexist) (community) - **Categories:** Automation, Developer tools, Jobs - **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Meinestadt.de Jobs Scraper: Collect German Job Listings Effortlessly --- ### What Is Meinestadt.de? Meinestadt.de is one of Germany's largest and most trusted job platforms, hosting thousands of positions across industries and regions. It connects job seekers with employers nationwide, from SMEs to Fortune 500 companies. The platform specializes in location-based job search and often features premium job listings with detailed compensation and requirement information. Collecting and analyzing this data manually is tedious; the **Meinestadt.de Jobs Scraper** automates data extraction, delivering structured records instantly. --- ### Overview The **Meinestadt.de Jobs Scraper** extracts comprehensive job detail pages from Meinestadt.de, converting rich HTML listings into clean, structured data. It is ideal for: - **Recruitment agencies** tracking active job placements and market dynamics - **HR professionals** benchmarking salaries and industry trends - **Researchers** analyzing German labor market patterns - **Job aggregators** building multi-source job databases - **Career analysts** monitoring skills demand across sectors The scraper handles multiple URLs in a single run, allows graceful failure handling, and returns 13 key fields per job for thorough analysis. --- ### Input Format The scraper accepts a JSON configuration object: ```json { "urls": [ "https://jobs.meinestadt.de/frankfurt-am-main/premium?id=100012734528", "https://jobs.meinestadt.de/rodgau/premium?id=100012816900" ], "max_items_per_url": 200, "ignore_url_failures": true } ```` | Parameter | Type | Description | |---|---|---| | `urls` | array | Direct links to individual Meinestadt.de job listing pages. Supports both standard and premium job URLs. | | `max_items_per_url` | integer | Maximum records to collect per URL (e.g., `200`). Useful for limiting dataset size. | | `ignore_url_failures` | boolean | If `true`, the scraper continues if some URLs fail; if `false`, the run halts on errors. | **Tips:** - Paste individual job URLs directly from your browser address bar - Premium listings (indicated by `/premium` in the URL) often contain richer data - Use bulk import to add multiple URLs at once - Setting a lower `max_items_per_url` speeds up testing *** ### Output Format **Sample output** ```json { "title": "Mitarbeiter*in (w/d/m) für den Bereich Finanzbuchhaltung, Fördermittel, Rechnungswesen", "description": "

Kaufmännischer Bereich:

\n \n

Administrativer Bereich:

\n\n\n

Ihr Profil:

\n\n\n\n

Firmenbeschreibung:

\n\nDie Hessische Landesstelle für Suchtfragen e.V. (HLS) ist das Vertretungsorgan der Spitzenverbände der Freien Wohlfahrtspflege im Bereich der Suchthilfe und Suchtprävention in Hessen. Als Dachorganisation vertritt sie mehr als 200 Einrichtungen der Suchthilfe und Suchtprävention sowie 550 Selbsthilfegruppen. Die HLS wird vorrangig vom Hessischen Ministerium für Soziales und Integration finanziert. Die hauptamtliche Geschäftsstelle in Frankfurt/M. mit derzeit 16 Mitarbeitenden übernimmt die ihr vom Vorstand delegierten Aufgaben.", "hiring_organization": "Hessische Landesstelle für Suchtfragen e.V. (HLS)", "industry": "Sozialwesen", "date_posted": "2026-07-17", "valid_through": "2026-08-18", "employment_type": "Teilzeit", "experience_requirements": "Mehrjährige Berufserfahrung", "job_location": { "address": { "postal_code": "60325", "address_locality": "Frankfurt am Main", "address_region": "n/a", "address_country": "Deutschland", "email": "hls@hls-online.org", "@type": "PostalAddress" }, "@type": "Place" }, "base_salary": { "currency": "EUR", "value": { "value": null, "min_value": 3676.33, "max_value": 5084.33, "unit_text": "MONTH", "@type": "QuantitativeValue" }, "@type": "MonetaryAmount" }, "direct_apply": true, "skills": "MS Office,FIBU,Finanzbuchführung,Sozialwirtschaft,Rechnungswesen,Berufsausbildung,Deutsch", "job_benefits": "Vereinbarkeit Familie & Beruf,Mobiles Arbeiten,Jahressonderzahlungen,Zusätzliche Urlaubstage,Weiterbildungsmaßnahmen,Homeoffice" } ``` Each scraped job returns a structured record with 13 essential fields: #### Core Job Information | Field | Description | Example | |---|---|---| | `Title` | The job title as displayed on the listing | "Senior Full-Stack Developer (m/w/d)" | | `Description` | Complete HTML job description, including tasks and requirements | `

Wir suchen einen erfahrenen...

` | | `Hiring Organization` | Official company name and employer details | "TechCorp GmbH" | | `Job Location` | City, region, or address where the role is based | "Frankfurt am Main, Germany" | #### Employment Details | Field | Description | Example | |---|---|---| | `Employment Type` | Contract type and job classification | "Vollzeit" (full-time), "Teilzeit" (part-time) | | `Experience Requirements` | Required years of experience and seniority level | "3-5 Jahre Berufserfahrung" | | `Industry` | Industry or sector classification | "Informationstechnologie", "Einzelhandel" | #### Salary & Compensation | Field | Description | Example | |---|---|---| | `Base Salary` | Offered salary range in EUR per month/year | "€2,500–€3,500 brutto/Monat" | | `Job Benefits` | Perks and additional benefits offered | "Homeoffice, Gesundheitsversicherung, Bonusregelung" | #### Skills & Application | Field | Description | Example | |---|---|---| | `Skills` | Required and preferred technical/soft skills | "Python, SQL, Scrum, Englisch" | | `Direct Apply` | URL for direct application or reference to external application method | `https://jobs.meinestadt.de/apply/...` | #### Dates & Validity | Field | Description | Example | |---|---|---| | `Date Posted` | When the listing was published on Meinestadt.de | "2024-01-15" | | `Valid Through` | Expiration date or deadline for applications | "2024-03-31" | *** ### How to Use 1. **Identify target jobs** — Browse Meinestadt.de and collect job URLs. Premium listings offer the most detail. 2. **Prepare URLs** — Copy the full URL from your browser (e.g., `https://jobs.meinestadt.de/frankfurt-am-main/premium?id=...`). 3. **Configure the scraper** — Paste URLs into the `urls` array. Adjust `max_items_per_url` as needed. 4. **Enable error tolerance** — Set `ignore_url_failures: true` for stability in multi-URL runs. 5. **Execute the run** — Start the actor and monitor progress in the logs. 6. **Export data** — Download output as JSON, CSV, or Excel for use in your tools. **Troubleshooting:** - If no data is returned, verify the URL points to a job *detail* page, not a search results page - Premium job URLs typically yield more complete data than standard listings - URLs with the `?id=` parameter are more reliable than others - Ensure you are scraping only data compliant with Meinestadt.de's ToS *** ### Use Cases & Business Value - **Salary benchmarking:** Compare compensation across roles, companies, and regions in Germany - **Skills gap analysis:** Identify which technical skills are most in-demand across industries - **Competitor tracking:** Monitor hiring volume and strategy of rival companies - **Market research:** Analyze employment trends in specific German cities or sectors - **Job aggregation:** Feed German job data into international job boards or internal HR systems - **Predictive hiring:** Correlate job posting frequency with economic cycles or seasonality By automating data collection, the Meinestadt.de Scraper reduces manual work by 90%+ and delivers insights that drive strategic HR decisions. *** ### Data Quality & Considerations - Most Meinestadt.de listings include salary bands, unlike some competitors — useful for market analysis - Descriptions may contain HTML formatting; the scraper preserves raw HTML for flexibility - Skills fields may vary in structure and completeness depending on employer input - Some listings may not include all 13 fields; missing data is returned as `null` - Data is returned in German and English depending on the original listing language *** ### Conclusion The **Meinestadt.de Jobs Scraper** is an essential tool for anyone analyzing the German job market. With 13 structured output fields — from salary data to skills requirements — it transforms Meinestadt listings into actionable intelligence. Whether you're a recruiter, analyst, or researcher, this scraper delivers the data you need in minutes, not hours. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Specific jobs urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## Actor input object example ```json { "urls": [ "https://jobs.meinestadt.de/frankfurt-am-main/premium?id=100012734528", "https://jobs.meinestadt.de/rodgau/premium?id=100012816900", "https://jobs.meinestadt.de/moerfelden-walldorf/premium?id=100012496966", "https://jobs.meinestadt.de/raunheim/premium?id=100012476432" ], "ignore_url_failures": true } ``` # 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 = { "urls": [ "https://jobs.meinestadt.de/frankfurt-am-main/premium?id=100012734528", "https://jobs.meinestadt.de/rodgau/premium?id=100012816900", "https://jobs.meinestadt.de/moerfelden-walldorf/premium?id=100012496966", "https://jobs.meinestadt.de/raunheim/premium?id=100012476432" ], "ignore_url_failures": true }; // Run the Actor and wait for it to finish const run = await client.actor("alexist/meinestadt-jobs-details-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 = { "urls": [ "https://jobs.meinestadt.de/frankfurt-am-main/premium?id=100012734528", "https://jobs.meinestadt.de/rodgau/premium?id=100012816900", "https://jobs.meinestadt.de/moerfelden-walldorf/premium?id=100012496966", "https://jobs.meinestadt.de/raunheim/premium?id=100012476432", ], "ignore_url_failures": True, } # Run the Actor and wait for it to finish run = client.actor("alexist/meinestadt-jobs-details-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 '{ "urls": [ "https://jobs.meinestadt.de/frankfurt-am-main/premium?id=100012734528", "https://jobs.meinestadt.de/rodgau/premium?id=100012816900", "https://jobs.meinestadt.de/moerfelden-walldorf/premium?id=100012496966", "https://jobs.meinestadt.de/raunheim/premium?id=100012476432" ], "ignore_url_failures": true }' | apify call alexist/meinestadt-jobs-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alexist/meinestadt-jobs-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Meinestadt Jobs Details Scraper", "description": "Scrape detailed job postings from Meinestadt.de, Germany's leading job portal. Extract titles, descriptions, salary ranges, company info, employment types, skills, and benefits — perfect for HR analytics, market research, and job board aggregation.", "version": "0.0", "x-build-id": "f8ANV0asDdtP17bHp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alexist~meinestadt-jobs-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alexist-meinestadt-jobs-details-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/alexist~meinestadt-jobs-details-scraper/runs": { "post": { "operationId": "runs-sync-alexist-meinestadt-jobs-details-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/alexist~meinestadt-jobs-details-scraper/run-sync": { "post": { "operationId": "run-sync-alexist-meinestadt-jobs-details-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": { "urls": { "title": "URLs of the Specific jobs urls to scrape", "type": "array", "description": "Add the URLs of the Specific jobs urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." } } }, "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 } } } } } } } } } } ```