# European Real Estate Aggregator (`luzodi/european-real-estate-aggregator`) Actor Aggregate property listings from Europe's major portals — Rightmove (UK), SeLoger (FR), Hemnet (SE), Funda (NL), plus Idealista (ES/IT/PT, beta) — in a single run. Returns cross-platform deduplicated listings in one unified schema. One API call instead of running each portal separately. - **URL**: https://apify.com/luzodi/european-real-estate-aggregator.md - **Developed by:** [Luuk Zoutendijk](https://apify.com/luzodi) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / actor start This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## European Real Estate Aggregator **Use this Actor when you need to:** - Scrape property listings from multiple European countries in a single API call - Compare real estate prices across UK, France, Sweden, the Netherlands, or Spain/Italy/Portugal - Build a property market dashboard, investment screener, or automated price-tracking tool - Get deduplicated listings when the same property appears on multiple portals **Supported markets:** UK (Rightmove), France (SeLoger), Sweden (Hemnet), Netherlands (Funda), Spain/Italy/Portugal (Idealista — beta) One run returns listings from all selected platforms, normalised to a **single schema** and **deduplicated** — no post-processing needed. ### Quickstart Cheapest run — UK apartments, no proxy needed: ```json { "searchQuery": "London", "platforms": ["rightmove"], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 50 } ```` French listings (residential proxy required for SeLoger): ```json { "searchQuery": "Paris", "platforms": ["seloger"], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` Multi-country run across three portals: ```json { "searchQuery": "Amsterdam", "platforms": ["funda", "rightmove", "hemnet"], "transactionType": "both", "maxResultsPerPlatform": 100 } ``` ### Platform coverage | Platform | Country | Status | Proxy needed | |----------|---------|--------|--------------| | Rightmove | 🇬🇧 UK | ✅ Active | No | | SeLoger | 🇫🇷 FR | ✅ Active | **Residential** (DataDome) | | Hemnet | 🇸🇪 SE | ✅ Active | No | | Funda | 🇳🇱 NL | ✅ Active | No | | Idealista | 🇪🇸🇮🇹🇵🇹 ES/IT/PT | 🧪 Beta | **Residential**, geo-matched | | Immoscout24 | 🇩🇪 DE | ⛔ Disabled | — (interactive CAPTCHA) | > **Note:** A single `searchQuery` matches one country, so each platform only returns results for queries in its own market (e.g. `"Paris"` → SeLoger, `"Amsterdam"` → Funda). Run per market, or pass a list of platforms that match your query. ### Pricing This Actor uses **pay-per-event** pricing: - **Per result** — you are charged for each listing returned (see the store page for the current per-result price). - **Actor start** — a small fixed charge per run. - **Platform usage** — Apify platform usage (compute + proxy) is billed on top of the events above. > **Cost tip:** SeLoger and Idealista run a real browser through a **residential proxy**, which is the main cost driver. Plain-HTTP platforms (Rightmove, Funda, Hemnet) are cheap. To control spend, scrape only the platforms you need and set a sensible `maxResultsPerPlatform`. A residential proxy is only required for SeLoger and Idealista. ### Input | Field | Type | Default | Notes | |-------|------|---------|-------| | `searchQuery` | string | — | **Required.** City/region/address. Match to the platform's market. | | `platforms` | string\[] | all active | `rightmove` (UK), `seloger` (FR), `hemnet` (SE), `funda` (NL), `idealista` (ES/IT/PT). | | `transactionType` | enum | `both` | `sale` | `rent` | `both`. | | `propertyType` | enum | `any` | `apartment` | `house` | `any`. | | `maxResultsPerPlatform` | int | 100 | 1–1000. Each result is billed separately. | | `minPrice` / `maxPrice` | int | — | Native currency: GBP (Rightmove), EUR (SeLoger/Funda/Idealista), SEK (Hemnet). | | `proxyConfiguration` | object | — | Set `useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"]` for SeLoger/Idealista. | ### Output Each dataset item is a normalised `PropertyListing`: ```json { "platforms": ["seloger"], "sourceListingIds": { "seloger": "26K8GBMVC9J7" }, "sourceUrls": { "seloger": "https://www.seloger.com/annonces/.../270391119.htm" }, "scrapedAt": "2026-06-03T15:11:41.626Z", "transactionType": "sale", "propertyType": "apartment", "price": 680000, "currency": "EUR", "pricePerSqm": 16190, "area": 42, "rooms": 2, "bedrooms": 1, "floor": 2, "city": "Paris 7ème arrondissement", "country": "FR", "images": [] } ``` When the same property appears on more than one platform, the records are merged: `platforms`, `sourceListingIds` and `sourceUrls` are combined, and missing fields are filled from the richest source. ### Cross-platform deduplication Two listings are treated as the same property when **all** of: - **Location** — GPS within 50 m, or address similarity > 90% - **Price** — within 5% - **Size** — living area within 5% The deduplication rate is reported in the `RUN_METADATA` key-value store record, alongside per-platform counts and any per-platform errors. ### Run metadata After each run, the `RUN_METADATA` record contains: ```json { "searchQuery": "Paris", "totalBeforeDedup": 120, "totalAfterDedup": 113, "deduplicationRate": "5.8%", "platformCounts": { "seloger": 50, "funda": 0, "hemnet": 0, "rightmove": 50 }, "platformErrors": {} } ``` One platform failing never fails the run — results from the others are still returned (`Promise.allSettled` isolation). ### Notes & limitations - **Idealista (beta):** protected by DataDome with per-country IP validation. It needs a residential proxy whose exit IP matches the listing country; the actor retries on fresh IPs but generic residential pools are often blocked. Geo-matched residential or a CAPTCHA-solving service improves reliability. - **Immoscout24:** disabled — it uses an interactive AWS WAF CAPTCHA that cannot be auto-solved without a solver integration. - **SeLoger:** requires a residential proxy (DataDome). The actor automatically retries on a fresh IP when blocked. # Actor input Schema ## `searchQuery` (type: `string`): Required. The city, region, or neighbourhood to search. Each platform only covers its own market — use a UK city for Rightmove (e.g. 'London', 'Manchester'), a French city for SeLoger (e.g. 'Paris', 'Lyon'), a Swedish city for Hemnet (e.g. 'Stockholm', 'Göteborg'), a Dutch city for Funda (e.g. 'Amsterdam', 'Rotterdam'), or a Spanish city for Idealista (e.g. 'Madrid', 'Barcelona'). ## `platforms` (type: `array`): Which portals to scrape. Each platform covers one market: rightmove=UK, seloger=FR (needs residential proxy), hemnet=SE, funda=NL, idealista=ES/IT/PT (beta, needs residential proxy). Only include platforms that match your searchQuery's country. Omit to scrape all active platforms. ## `transactionType` (type: `string`): Whether to return for-sale listings ('sale'), rental listings ('rent'), or both. Use 'sale' for property purchases, 'rent' for rental market data, 'both' to collect all listings. ## `propertyType` (type: `string`): Type of property to return: 'apartment' for flats and studios, 'house' for detached, semi-detached and terraced houses, 'any' for all property types. Default is 'any'. ## `maxResultsPerPlatform` (type: `integer`): Maximum number of listings to collect per platform. Each result is billed separately under pay-per-event pricing. Use 10–25 for quick tests, up to 1000 for bulk collection. Default is 100. ## `minPrice` (type: `integer`): Optional minimum listing price in the platform's native currency: GBP for Rightmove, EUR for SeLoger / Funda / Idealista, SEK for Hemnet. ## `maxPrice` (type: `integer`): Optional maximum listing price in the platform's native currency: GBP for Rightmove, EUR for SeLoger / Funda / Idealista, SEK for Hemnet. ## `proxyConfiguration` (type: `object`): Proxy settings. SeLoger (FR) and Idealista (ES/IT/PT) require a residential proxy due to DataDome bot protection — set useApifyProxy=true and apifyProxyGroups=\['RESIDENTIAL']. Rightmove, Funda, and Hemnet work without any proxy and do not need this field. ## Actor input object example ```json { "searchQuery": "London", "platforms": [ "rightmove" ], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 10 } ``` # Actor output Schema ## `listings` (type: `string`): Deduplicated, normalised property listings collected from all selected platforms. # 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": "London", "platforms": [ "rightmove" ], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("luzodi/european-real-estate-aggregator").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": "London", "platforms": ["rightmove"], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 10, } # Run the Actor and wait for it to finish run = client.actor("luzodi/european-real-estate-aggregator").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": "London", "platforms": [ "rightmove" ], "transactionType": "sale", "propertyType": "apartment", "maxResultsPerPlatform": 10 }' | apify call luzodi/european-real-estate-aggregator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=luzodi/european-real-estate-aggregator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "European Real Estate Aggregator", "description": "Aggregate property listings from Europe's major portals — Rightmove (UK), SeLoger (FR), Hemnet (SE), Funda (NL), plus Idealista (ES/IT/PT, beta) — in a single run. Returns cross-platform deduplicated listings in one unified schema. One API call instead of running each portal separately.", "version": "0.1", "x-build-id": "VohgEKmKySXQ8QJNa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzodi~european-real-estate-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzodi-european-real-estate-aggregator", "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/luzodi~european-real-estate-aggregator/runs": { "post": { "operationId": "runs-sync-luzodi-european-real-estate-aggregator", "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/luzodi~european-real-estate-aggregator/run-sync": { "post": { "operationId": "run-sync-luzodi-european-real-estate-aggregator", "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", "required": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Required. The city, region, or neighbourhood to search. Each platform only covers its own market — use a UK city for Rightmove (e.g. 'London', 'Manchester'), a French city for SeLoger (e.g. 'Paris', 'Lyon'), a Swedish city for Hemnet (e.g. 'Stockholm', 'Göteborg'), a Dutch city for Funda (e.g. 'Amsterdam', 'Rotterdam'), or a Spanish city for Idealista (e.g. 'Madrid', 'Barcelona')." }, "platforms": { "title": "Platforms", "type": "array", "description": "Which portals to scrape. Each platform covers one market: rightmove=UK, seloger=FR (needs residential proxy), hemnet=SE, funda=NL, idealista=ES/IT/PT (beta, needs residential proxy). Only include platforms that match your searchQuery's country. Omit to scrape all active platforms.", "items": { "type": "string", "enum": [ "rightmove", "idealista", "immoscout24", "seloger", "hemnet", "funda" ] }, "default": [ "rightmove", "hemnet", "funda", "seloger", "idealista" ] }, "transactionType": { "title": "Transaction Type", "enum": [ "sale", "rent", "both" ], "type": "string", "description": "Whether to return for-sale listings ('sale'), rental listings ('rent'), or both. Use 'sale' for property purchases, 'rent' for rental market data, 'both' to collect all listings.", "default": "both" }, "propertyType": { "title": "Property Type", "enum": [ "apartment", "house", "any" ], "type": "string", "description": "Type of property to return: 'apartment' for flats and studios, 'house' for detached, semi-detached and terraced houses, 'any' for all property types. Default is 'any'.", "default": "any" }, "maxResultsPerPlatform": { "title": "Max Results Per Platform", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to collect per platform. Each result is billed separately under pay-per-event pricing. Use 10–25 for quick tests, up to 1000 for bulk collection. Default is 100.", "default": 100 }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Optional minimum listing price in the platform's native currency: GBP for Rightmove, EUR for SeLoger / Funda / Idealista, SEK for Hemnet." }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Optional maximum listing price in the platform's native currency: GBP for Rightmove, EUR for SeLoger / Funda / Idealista, SEK for Hemnet." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. SeLoger (FR) and Idealista (ES/IT/PT) require a residential proxy due to DataDome bot protection — set useApifyProxy=true and apifyProxyGroups=['RESIDENTIAL']. Rightmove, Funda, and Hemnet work without any proxy and do not need this field." } } }, "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 } } } } } } } } } } ```