# Wonglueck Parser Spider (`getdataforme/wonglueck-parser-spider`) Actor The Wonglueck Parser Spider automates scraping comprehensive property data from Wohnglueck.de, extracting prices, locations, descriptions, and images.... - **URL**: https://apify.com/getdataforme/wonglueck-parser-spider.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Agents, E-commerce - **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 results 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Wonglueck Parser Spider ### Introduction The Wonglueck Parser Spider is a powerful Apify Actor designed to scrape and extract detailed property data from Wohnglueck.de, a leading German real estate platform. It automates the collection of property listings, enabling users to gather comprehensive information on apartments, houses, and other real estate offerings efficiently. This tool is ideal for real estate professionals, researchers, and businesses seeking reliable data for market analysis, investment decisions, and portfolio management. ### Features - **Comprehensive Data Extraction**: Scrapes key property details including prices, locations, descriptions, and images from Wohnglueck.de listings. - **High Reliability**: Built with robust error handling to ensure consistent data retrieval even from dynamic web pages. - **Scalable Performance**: Supports batch processing of multiple URLs, making it suitable for large-scale data collection. - **Customizable Inputs**: Flexible configuration options to target specific properties or regions. - **JSON Output**: Delivers structured data in JSON format for easy integration with databases, analytics tools, or APIs. - **Apify Integration**: Seamlessly runs on the Apify platform with built-in monitoring, scheduling, and export capabilities. - **Data Quality Assurance**: Filters out irrelevant content and ensures clean, actionable datasets. ### Input Parameters | Parameter | Type | Required | Description | Example | |-----------|------|----------|-------------|---------| | Urls | array | No | A list of URLs from Wohnglueck.de to scrape property data from. Each URL should point to a specific property page. | ["https://wohnglueck.de/property/817376", "https://wohnglueck.de/property/123456"] | ### Example Usage To run the Wonglueck Parser Spider, provide the input in JSON format as shown below: ```json { "Urls": [ "https://wohnglueck.de/property/817376" ] } ```` Example output (structured JSON with property details): ```json { "propertyId": "817376", "title": "Modern Apartment in Berlin", "price": "€1,200/month", "location": "Berlin, Germany", "description": "A spacious 2-bedroom apartment with modern amenities.", "images": ["https://wohnglueck.de/image1.jpg", "https://wohnglueck.de/image2.jpg"], "features": ["Balcony", "Parking", "Pet-friendly"] } ``` ### Use Cases - **Market Research and Analysis**: Gather data on property prices and trends in specific German cities for investment reports. - **Competitive Intelligence**: Monitor competitors' listings to benchmark pricing and features. - **Price Monitoring**: Track rental or sale prices over time for dynamic pricing strategies. - **Content Aggregation**: Build databases of real estate listings for websites or apps. - **Academic Research**: Collect data for studies on housing markets, urbanization, or economic indicators. - **Business Automation**: Automate lead generation for real estate agents by extracting contact details and property specs. ### Installation and Usage 1. Search for "Wonglueck Parser Spider" in the Apify Store. 2. Click "Try for free" or "Run". 3. Configure input parameters (e.g., list of URLs). 4. Click "Start" to begin extraction. 5. Monitor progress in the log. 6. Export results in your preferred format (JSON, CSV, Excel). ### Output Format The Actor outputs data in JSON format, with each scraped property represented as an object. Key fields include: - `propertyId`: Unique identifier for the property. - `title`: The property's headline title. - `price`: Rental or sale price. - `location`: Address or city details. - `description`: Detailed property description. - `images`: Array of image URLs. - `features`: List of amenities or features. This structured output ensures easy parsing and integration. ### Error Handling The Actor includes built-in error handling for common issues like invalid URLs, network timeouts, or page changes. If a URL fails, it logs the error and continues with others. For persistent issues, check the Apify console logs for details. Ensure URLs are correctly formatted and accessible. ### Rate Limiting and Best Practices Apify enforces rate limits to prevent overloading target sites; respect these to avoid bans. Best practices include: - Limit concurrent runs to 1-2 for optimal performance. - Use proxies if needed for high-volume scraping. - Schedule runs during off-peak hours. - Validate inputs before execution to minimize errors. ### Limitations and Considerations - Only scrapes public Wohnglueck.de pages; login-required content is not accessible. - Output may vary based on site updates; monitor for changes. - Large URL lists may increase runtime; batch accordingly. - Ensure compliance with Wohnglueck.de's terms of service and legal regulations on data scraping. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: https://getdataforme.com/contact/ We're here to help you get the most out of this Actor! *** # Actor input Schema ## `Urls` (type: `array`): The urls for the spider. ## Actor input object example ```json { "Urls": [ "https://wohnglueck.de/property/817376" ] } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/wonglueck-parser-spider").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 = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/wonglueck-parser-spider").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 '{}' | apify call getdataforme/wonglueck-parser-spider --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/wonglueck-parser-spider", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Wonglueck Parser Spider", "description": "The Wonglueck Parser Spider automates scraping comprehensive property data from Wohnglueck.de, extracting prices, locations, descriptions, and images....", "version": "0.0", "x-build-id": "9HEHeMcqUGFFTpRrv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~wonglueck-parser-spider/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-wonglueck-parser-spider", "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/getdataforme~wonglueck-parser-spider/runs": { "post": { "operationId": "runs-sync-getdataforme-wonglueck-parser-spider", "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/getdataforme~wonglueck-parser-spider/run-sync": { "post": { "operationId": "run-sync-getdataforme-wonglueck-parser-spider", "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", "minItems": 1, "type": "array", "description": "The urls for the spider.", "default": [ "https://wohnglueck.de/property/817376" ], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```