Overview
This node extracts detailed real estate investment data from the ImmoMetrica platform using a CSV-based approach combined with optional detail page scraping. It automates login, navigates saved searches, downloads and parses CSV data of properties, and optionally scrapes additional details from individual property pages to enrich the dataset.
Typical use cases include:
- Automating extraction of large sets of real estate listings for investment analysis.
- Filtering properties by ROI, price, location, and cashflow criteria.
- Gathering comprehensive investment KPIs such as expected rent, yield, market valuation, and cashflow.
- Integrating ImmoMetrica data into workflows for portfolio management or market research.
Example: Extract up to 100 properties from a saved search filtered for Berlin with minimum ROI of 5%, including detailed scraping for enhanced data fields.
Properties
| Name | Meaning |
|---|---|
| Gespeicherte Suche | Select a saved search from ImmoMetrica to extract property data from. |
| Such-Name (Optional) | Optional name for the search used for logging or tracking purposes. |
| Maximale Ergebnisse | Maximum number of properties to extract (1 to 1000). |
| Details Scraping Aktivieren | Enable additional scraping of property detail pages for more comprehensive data (slower). |
| Filter-Optionen | Advanced filter criteria for refining extracted properties: |
| - Mindest-ROI (%) (minimum ROI percentage) | |
| - Maximal-ROI (%) (maximum ROI percentage) | |
| - Mindestpreis (€) (minimum price in euros) | |
| - Maximalpreis (€) (maximum price in euros) | |
| - Standort-Filter (comma-separated list of locations to filter by) | |
| - Nur positive Cashflows (only show properties with positive cashflow) |
Output
The node outputs an array of JSON objects, each representing a single property with structured investment data fields. Each property object includes:
- Basic info: address, title, postal code, property type, availability, year built, etc.
- Financial KPIs: purchase price, expected rent per month and per sqm, expected and actual yield percentages, gross yield, estimated rents, market valuation, market deviation percentage, cashflow.
- Additional metadata: source search ID and name, scrape timestamp.
- Optional enriched details if detail scraping is enabled, such as amenities, commission, energy certificate status, regional statistics, and links to other platforms.
- Platform-specific URLs and agent contact info if available.
If binary data were involved (not in this operation), it would be summarized accordingly, but here output is purely JSON.
Dependencies
- Requires valid credentials for ImmoMetrica API (email, password, base URL).
- Uses Selenium WebDriver with Chrome in headless mode for browser automation.
- Requires Chrome/Chromium installed in the n8n environment (self-hosted recommended).
- Uses cheerio library for HTML parsing.
- Node-cache for session and CSV caching to optimize repeated requests.
Environment setup notes:
- For Docker/self-hosted: Chrome must be installed inside the container.
- Not compatible with n8n Cloud due to Chrome dependency.
- Alternative approaches suggested if Chrome is unavailable (e.g., HTTP request nodes).
Troubleshooting
- Chrome WebDriver errors: If Chrome is not installed or accessible, the node will fail with messages suggesting installation steps.
- Login failures: Errors indicating invalid credentials or session expiration require checking the provided email/password and base URL.
- CSV download issues: If no property data is found or CSV export fails, fallback table scraping is attempted; persistent failure may indicate site layout changes or network issues.
- Parameter validation errors: The node validates inputs strictly; e.g., maxResults must be between 1 and 1000, savedSearchId is mandatory for extraction.
- Session expiration during execution: The node detects expired sessions and re-authenticates automatically.
- Performance: Enabling detail scraping significantly slows down extraction due to multiple page loads; consider limiting maxResults accordingly.
Links and References
- ImmoMetrica platform: https://immometrica.de/
- Selenium WebDriver for Chrome: https://www.selenium.dev/documentation/webdriver/browsers/chrome/
- Cheerio HTML parser: https://cheerio.js.org/
- n8n documentation on custom nodes and credentials: https://docs.n8n.io/
This summary covers the "Immobiliendaten Extrahieren (CSV)" operation of the ImmoMetrica v2 node, detailing its input parameters, output structure, dependencies, and common troubleshooting points based on static code analysis.