# Funda.nl Real Estate Scraper (`santamaria-automations/funda-nl-scraper`) Actor Scrape property listings from Funda.nl, the Netherlands' #1 real estate portal. Extract prices, addresses, photos, property details, energy labels, and agent contact info for buy and rent listings. - **URL**: https://apify.com/santamaria-automations/funda-nl-scraper.md - **Developed by:** [Alessandro Santamaria](https://apify.com/santamaria-automations) (community) - **Categories:** Real estate, Lead generation, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 property listing 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 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 ## Funda.nl Real Estate Scraper Scrape every property on [Funda.nl](https://www.funda.nl) — the Netherlands' #1 real estate portal with 93% brand awareness and 300,000+ active listings. Essential for Dutch real estate intelligence, investment research, and proptech analytics. Extract prices, addresses, coordinates, photos, full descriptions, energy labels, room counts, construction year, and more — for both buy (**koop**) and rent (**huur**) listings across every Dutch city. Pay only for the results you scrape. ### Features - **Buy and rent** — Scrapes both `/zoeken/koop` and `/zoeken/huur` markets - **Direct URL or city name** — Paste a Funda search URL or just type `amsterdam`, `rotterdam`, `utrecht`, `den-haag`, ... - **Full pagination** — Walks through every SERP page (15 listings / page) up to your `maxResults` limit - **Rich property data** — 35+ fields including GPS coordinates, neighborhood, full description, all photos, energy label, room breakdown - **Dutch energy label decoding** — Correctly handles A+, A++, A+++, A++++ and all B-G labels - **Structured address parsing** — Street, postal code (with Dutch space), city, neighborhood, province, country - **30+ photos per listing** — Full-resolution image URLs straight from Funda's CDN - **Full description text** — Complete Dutch "Omschrijving" content, typically 3,000-6,000 characters per listing - **Feature tags** — Amenities like garden, balcony, parking, heating type, construction type - **Dedup across pages** — Every listing ID returned exactly once - **Fast HTTP-only scraper** — 128 MB memory, no headless browser, ~1 second per SERP page - **Pay-per-result pricing** — Only pay for what you actually scrape ### Output Fields Every result includes these fields: | Field | Type | Description | |-------|------|-------------| | `property_image_url` | string | Primary listing photo (displayed as image thumbnail in the Apify console) | | `id` | string | Unique Funda listing ID | | `title` | string | Listing title (usually the street address) | | `url` | string | Canonical Funda detail URL | | `listing_type` | string | `koop` (buy) or `huur` (rent) | | `price` | number | Asking price (EUR) or monthly rent (EUR) | | `price_currency` | string | Always `EUR` | | `price_original` | number | Original asking price if the listing has been reduced | | `price_per_m2` | number | Price per square meter of living area | | `address` | string | Full formatted address | | `street` | string | Street and house number | | `city` | string | City name | | `postal_code` | string | Dutch postal code, e.g. `1017 DM` | | `neighborhood` | string | Official Funda neighborhood, e.g. `Jordaan`, `Spiegelbuurt` | | `province` | string | Dutch province, e.g. `Noord-Holland` | | `country` | string | Always `NL` | | `latitude` | number | WGS84 latitude | | `longitude` | number | WGS84 longitude | | `property_type` | string | `apartment`, `house`, `villa`, `bungalow`, `parking`, `land` | | `bedrooms` | number | Number of bedrooms | | `rooms` | number | Total number of rooms | | `bathrooms` | number | Number of bathrooms | | `living_area_m2` | number | Living area in square meters | | `plot_size_m2` | number | Plot size in square meters (houses only) | | `year_built` | number | Construction year | | `energy_label` | string | Dutch energy label: `A+++++`, `A++++`, `A+++`, `A++`, `A+`, `A`, `B`, `C`, `D`, `E`, `F`, `G` | | `heating_type` | string | Heating system, e.g. `Cv-ketel`, `Stadsverwarming`, `Warmtepomp` | | `construction_type` | string | `Bestaande bouw` (existing) or `Nieuwbouw` (new build) | | `description` | string | Full Dutch listing description (plain text, typically 3,000-6,000 chars) | | `features` | string[] | Amenity tags (balcony, garden, parking, insulation level, ...) | | `photos` | string[] | All listing photo URLs in original order (full resolution) | | `agent_name` | string | Listing agent / agency name (when visible on SERP) | | `agent_phone` | string | Agent phone number (when available — see note below) | | `agent_email` | string | Agent email address (when available — see note below) | | `agent_url` | string | Agent profile page URL | | `listed_since` | string | Date the listing was first published | | `source_url` | string | Original Funda detail URL | | `source_platform` | string | Always `funda.nl` | | `scraped_at` | string | ISO-8601 UTC timestamp | > Note on agent contact details: Funda hides agent phone and email behind a "Log in om te bekijken" wall for unauthenticated visitors. `agent_name` and `agent_url` are extracted from the listing card when present. `agent_phone` / `agent_email` are populated only when the listing exposes them publicly. ### Real Output Example ```json { "property_image_url": "https://cloud.funda.nl/valentina_media/227/009/834.jpg", "id": "43300313", "title": "Aldengoor 2", "url": "https://www.funda.nl/detail/koop/amsterdam/huis-aldengoor-2/43300313/", "listing_type": "koop", "price": 3400000, "price_currency": "EUR", "price_per_m2": 9341, "address": "Aldengoor 2, 1083 AK Amsterdam", "street": "Aldengoor 2", "city": "Amsterdam", "postal_code": "1083 AK", "neighborhood": "Buitenveldert-Zuidoost", "province": "Noord-Holland", "country": "NL", "latitude": 52.32434, "longitude": 4.885988, "property_type": "house", "bedrooms": 7, "rooms": 9, "bathrooms": 5, "living_area_m2": 364, "plot_size_m2": 689, "year_built": 1964, "energy_label": "A+", "heating_type": "Cv-ketel, open haard, gedeeltelijke vloerverwarming en warmtepomp", "construction_type": "Bestaande bouw", "description": "Luxe, royaal en exclusief zijn de drie kernwoorden die deze vrijstaande villa van 364m² het beste omschrijven. Deze moderne villa beschikt over een riante voor-, zij- en achtertuin inclusief een verwarmd zwembad...", "features": [ "Soort woonhuis: Villa, vrijstaande woning", "Soort dak: Plat dak", "Isolatie: Volledig geïsoleerd", "Tuin: Achtertuin, voortuin en zijtuin", "Balkon/dakterras: Dakterras aanwezig en balkon aanwezig", "Soort garage: Parkeerplaats en vrijstaande stenen garage" ], "photos": [ "https://cloud.funda.nl/valentina_media/227/009/834.jpg", "https://cloud.funda.nl/valentina_media/227/009/921.jpg", "https://cloud.funda.nl/valentina_media/227/009/836.jpg", "... 55 more photos" ], "agent_name": "CSV Makelaars B.V.", "agent_url": "https://www.funda.nl/makelaar/24635-csv-makelaars-bv/", "listed_since": "2026-04-09T00:00:00Z", "source_url": "https://www.funda.nl/detail/koop/amsterdam/huis-aldengoor-2/43300313/", "source_platform": "funda.nl", "scraped_at": "2026-04-10T10:18:12Z" } ```` ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `searchUrls` | string\[] | One or more Funda search URLs. Example: `https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D` | — | | `city` | string | Alternative: Dutch city slug. `amsterdam`, `rotterdam`, `utrecht`, `den-haag`, `eindhoven`, `groningen`, ... Used when `searchUrls` is empty. | — | | `listingType` | string | `koop` (buy) or `huur` (rent). Only used together with `city`. | `koop` | | `maxResults` | number | Maximum listings to return across all pages | `100` | | `includeDetails` | boolean | Fetch detail pages for full descriptions, all photos, coordinates, neighborhood, year built, heating, rooms, and more | `true` | | `proxyConfiguration` | object | Apify proxy settings. Default `auto` works reliably and is the cheapest option. | `{useApifyProxy: true}` | Either `searchUrls` or `city` must be provided. `searchUrls` takes precedence and lets you use Funda's advanced filters (price range, area, rooms, energy label, …). #### Example: Amsterdam apartments under €500K, minimum 2 rooms ```json { "searchUrls": [ "https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D&price=%22-500000%22&object_type=%5B%22apartment%22%5D&rooms=%222-%22" ], "maxResults": 300, "includeDetails": true } ``` #### Example: Rental listings in Rotterdam (cheap mode — no details) ```json { "city": "rotterdam", "listingType": "huur", "maxResults": 500, "includeDetails": false } ``` ### Use Cases - **Dutch real estate market analysis** — Track asking prices, time-on-market, and inventory trends across all Dutch cities - **Amsterdam / Rotterdam / Utrecht investment research** — Find undervalued properties in high-growth neighborhoods - **Rental yield calculation** — Compare buy (koop) vs rent (huur) prices on the same streets to compute cap rates - **Neighborhood price heatmaps** — Build interactive maps with `latitude`/`longitude` + `price_per_m2` - **Lead generation for makelaars** — Target agents based on listing volume and pricing tier - **PropTech data pipelines** — Feed clean, structured JSON into BI tools, data warehouses, or ML models - **Historical price tracking** — Run daily to record price reductions and detect distressed sales - **Relocation and expat tools** — Aggregate listings filtered by school, transport, or amenity preferences - **Competitive benchmarking** — Compare your listings against the full Funda market ### Pricing | Event | Price | |-------|-------| | Actor start | $0.001 | | Search result (SERP only, `includeDetails=false`) | $0.003 per listing | | Detail result (`includeDetails=true`) | $0.008 per listing | When `includeDetails` is `true`, each listing charges the detail rate — not both rates. A full 100-listing Amsterdam scrape with full details costs **~$0.80**. ### Why This Scraper - **HTTP-only, not a browser** — runs in 128 MB of RAM, ~1 second per page. No Playwright overhead. - **Pay per result, not per hour** — you're never billed for warming up a browser or retrying a Captcha. - **No monthly rental** — pay only when you run it. Perfect for one-off market studies or daily cron jobs. - **Structured Nuxt data extraction** — we parse Funda's internal state directly, so every field comes out clean: full descriptions, photo galleries, GPS coordinates, typed room counts, and the correct energy label (A+ ≠ A1). - **Works out of the box** — `auto` proxy is the default. No RESIDENTIAL required. - **Field coverage verified** — Tested to populate every documented field on 100% of real Amsterdam, Rotterdam, and Utrecht listings where the data is publicly visible on Funda. ### Issues & Feedback Facing an issue, or missing a feature or data field? [Open an issue on the Issues tab](https://console.apify.com/actors/tEZqHc8INIbx2OWwG/issues) — we respond quickly and ship fixes regularly. *** ### Related Actors If you scrape Dutch / European real estate, you may also want: - [Immoweb.be Scraper](https://apify.com/santamaria-automations/immoweb-be-scraper) — Belgium's #1 real estate portal (EN/FR/NL) - [Homegate.ch Scraper](https://apify.com/santamaria-automations/homegate-scraper) — Switzerland's leading real estate portal - [ImmobilienScout24 Scraper](https://apify.com/santamaria-automations/immobilienscout24-scraper) — Germany's #1 real estate portal - [Immowelt.de Scraper](https://apify.com/santamaria-automations/immowelt-de-scraper) — Germany's #2 real estate portal - [AutoScout24 Scraper](https://apify.com/santamaria-automations/autoscout24-scraper) — European used car marketplace - [Google Maps Scraper](https://apify.com/santamaria-automations/google-maps-scraper) — Local business intelligence - [Website Contact Extractor](https://apify.com/santamaria-automations/website-contact-extractor) — Enrich any website with contact data Or browse all [santamaria-automations actors](https://apify.com/santamaria-automations) for the full DACH + European scraping suite. # Actor input Schema ## `searchUrls` (type: `array`): Paste Funda.nl search URLs directly. Example: https://www.funda.nl/zoeken/koop?selected\_area=%5B%22amsterdam%22%5D ## `city` (type: `string`): Dutch city name (e.g. amsterdam, rotterdam, utrecht, den-haag, eindhoven). Used when no searchUrls provided. ## `listingType` (type: `string`): koop (buy) or huur (rent). Ignored when full search URLs are provided. ## `maxResults` (type: `integer`): Maximum number of property listings to scrape across all pages ## `includeDetails` (type: `boolean`): Fetch detail pages for full descriptions, all photos, coordinates, neighborhood, year built, heating type, plot size, and room counts. Slower (+2s per listing) but much richer. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Defaults to 'auto' (cheapest) which works reliably with Funda. RESIDENTIAL is only needed for very high volumes. ## Actor input object example ```json { "searchUrls": [ "https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D" ], "listingType": "koop", "maxResults": 20, "includeDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing scraped Funda.nl property listings # 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 = { "searchUrls": [ "https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D" ], "maxResults": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/funda-nl-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 = { "searchUrls": ["https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D"], "maxResults": 20, } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/funda-nl-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 '{ "searchUrls": [ "https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D" ], "maxResults": 20 }' | apify call santamaria-automations/funda-nl-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=santamaria-automations/funda-nl-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Funda.nl Real Estate Scraper", "description": "Scrape property listings from Funda.nl, the Netherlands' #1 real estate portal. Extract prices, addresses, photos, property details, energy labels, and agent contact info for buy and rent listings.", "version": "1.0", "x-build-id": "DVb6uDpFF9zy0CGba" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~funda-nl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-funda-nl-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/santamaria-automations~funda-nl-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-funda-nl-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/santamaria-automations~funda-nl-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-funda-nl-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste Funda.nl search URLs directly. Example: https://www.funda.nl/zoeken/koop?selected_area=%5B%22amsterdam%22%5D", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Dutch city name (e.g. amsterdam, rotterdam, utrecht, den-haag, eindhoven). Used when no searchUrls provided." }, "listingType": { "title": "Listing Type", "enum": [ "koop", "huur" ], "type": "string", "description": "koop (buy) or huur (rent). Ignored when full search URLs are provided.", "default": "koop" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of property listings to scrape across all pages", "default": 100 }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Fetch detail pages for full descriptions, all photos, coordinates, neighborhood, year built, heating type, plot size, and room counts. Slower (+2s per listing) but much richer.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Defaults to 'auto' (cheapest) which works reliably with Funda. RESIDENTIAL is only needed for very high volumes.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```