# Funda Property Scraper (Cheap) (`data_api/funda-property-scraper-cheap`) Actor

Funda property extractor that collects Dutch housing listings from funda.nl, so anyone tracking prices, comparing neighborhoods, or researching the Netherlands real estate market gets structured data fast.

- **URL**: https://apify.com/data\_api/funda-property-scraper-cheap.md
- **Developed by:** [Data API](https://apify.com/data_api) (community)
- **Categories:** Real estate, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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/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

## Funda Property Scraper

![Funda Property Scraper](cover.jpg)

Tracking the Dutch housing market usually means copying details off funda.nl one listing at a time: address, price, floor area, energy label, agent. This scraper does that for you. Paste a funda.nl search URL and every listing comes back as a clean row, with the price, location, size, and agent already split into fields and ready for a spreadsheet or a model. It's fast, cheap, and code-free, and you only pay for what you scrape.

### What you get

Each listing comes back as one row with three kinds of data:

- **Location** — `streetAddress`, `postCode`, `cityName`, `districtName`, plus the `listingUrl` and `propertyId`
- **Price and size** — `priceValue`, `priceLabel`, `priceTerms`, `livingAreaSqm`, `plotAreaSqm`, `roomCount`, `bedroomCount`, `energyRating`, `propertyType`
- **Listing and agent** — `listingStatus`, `dealType`, `publishedDate`, `summary`, `brokerName`, `brokerUrl`, `coverImage`, `imageLinks`, `collectedAt`

### Quick start

1. Open funda.nl, apply your filters (area, price, type), and copy the URL from the address bar.
2. Hit **Try for free** and paste that URL into **Search URLs**.
3. Set a **Results limit** to control how many listings you pull.
4. Press **Start**, then export the results as JSON, CSV, Excel, or XML.

![How it works](how-it-works.jpg)

### Use cases

- **Price tracking** — watch asking prices across a city or district and spot reductions early
- **Neighbourhood comparison** — compare price per m², room counts, and energy labels between areas
- **Investment research** — build a dataset of for-sale or rental stock to score against your criteria
- **Agent and brokerage analysis** — see which brokers list what, where, and at what price
- **Market dashboards** — feed live funda.nl data into your own sheet, BI tool, or app

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `targetUrls` | array of strings | Yes | funda.nl search URLs to scrape; each one runs with full pagination. Prefilled with a Rotterdam for-sale search. |
| `resultsLimit` | integer | No | How many listings to pull per run. Default `20`. |
| `timeoutSeconds` | integer | No | Seconds to wait on each request before it times out. Default `45`. |

#### Example input

```json
{
    "targetUrls": [
        "https://www.funda.nl/zoeken/koop/?selected_area=%5B%22rotterdam%22%5D"
    ],
    "resultsLimit": 20,
    "timeoutSeconds": 45
}
````

### Output

Every listing on the search results becomes one row, paginated automatically up to your limit. Fields that funda.nl does not publish for a given property come back absent rather than guessed.

#### Example output

```json
{
    "propertyId": "43891204",
    "listingUrl": "https://www.funda.nl/detail/koop/rotterdam/appartement-westersingel-12-a/43891204/",
    "streetAddress": "Westersingel 12 A",
    "postCode": "3014 GN",
    "cityName": "Rotterdam",
    "districtName": "Cool",
    "priceValue": 395000,
    "priceLabel": "€ 395.000 k.k.",
    "priceTerms": "k.k.",
    "livingAreaSqm": 78,
    "plotAreaSqm": null,
    "roomCount": 3,
    "bedroomCount": 2,
    "propertyType": "Appartement",
    "energyRating": "B",
    "publishedDate": "2026-06-20",
    "coverImage": "https://cloud.funda.nl/valentina/previews/large/example-1.jpg",
    "imageLinks": [
        "https://cloud.funda.nl/valentina/previews/large/example-1.jpg",
        "https://cloud.funda.nl/valentina/previews/large/example-2.jpg"
    ],
    "brokerName": "Ruimzicht Makelaars",
    "brokerUrl": "https://www.funda.nl/makelaar/rotterdam/12345-ruimzicht-makelaars/",
    "listingStatus": "te koop",
    "dealType": "koop",
    "summary": "Light three-room apartment in the heart of Cool, a short walk from Witte de Withstraat and Rotterdam Centraal.",
    "collectedAt": "2026-06-29T12:00:00.000000+00:00"
}
```

#### Output fields

| Field | Type | Description |
|-------|------|-------------|
| `propertyId` | string | Funda object identifier for the listing |
| `listingUrl` | string | Direct link to the listing on funda.nl |
| `streetAddress` | string | Street name and house number |
| `postCode` | string | Dutch postal code in 1234 AB format |
| `cityName` | string | Town or city |
| `districtName` | string | District or neighbourhood within the city |
| `priceValue` | integer | Asking price in euros; null when not shown |
| `priceLabel` | string | Price as printed on funda.nl, e.g. `€ 425.000 k.k.` |
| `priceTerms` | string | k.k. (buyer covers costs) or v.o.n. (seller covers costs) |
| `livingAreaSqm` | integer | Indoor living space in m² |
| `plotAreaSqm` | integer | Land area in m²; null for apartments |
| `roomCount` | integer | Total rooms |
| `bedroomCount` | integer | Number of bedrooms |
| `propertyType` | string | Category, e.g. Appartement, Tussenwoning, Hoekwoning |
| `energyRating` | string | Energy label A through G |
| `publishedDate` | string | ISO 8601 date the listing went live |
| `coverImage` | string | Link to the main listing photo |
| `imageLinks` | array | Every photo URL for the listing |
| `brokerName` | string | Estate agent or broker name |
| `brokerUrl` | string | Link to the broker profile on funda.nl |
| `listingStatus` | string | te koop, te huur, verkocht, verhuurd, or onder bod |
| `dealType` | string | koop (for sale) or huur (for rent) |
| `summary` | string | First 300 characters of the marketing text |
| `collectedAt` | string | ISO 8601 timestamp of when the row was captured |

### Tips for best results

- **Filter on funda.nl first.** The more specific your search URL (area, price band, property type), the cleaner and more relevant your dataset.
- **Use `resultsLimit` for test runs.** Start with 20 to confirm the output fits your pipeline, then raise it for the full pull.
- **Both koop and huur work.** A `/koop` URL returns for-sale stock and a `/huur` URL returns rentals; `dealType` and `listingStatus` tell them apart.
- **Some fields are sparse on certain listings.** `plotAreaSqm` is null for apartments, and a few listings hide the price — those rows still carry everything else.
- **Raise `timeoutSeconds`** if you see timeouts on large result sets.

### How can I use Funda property data?

**How can I use the Funda Property Scraper to track Dutch house prices?**
Paste a funda.nl search URL for your target area and run it on a schedule. Each row carries `priceValue`, `priceLabel`, `streetAddress`, and `publishedDate`, so you can chart asking prices over time and flag reductions the day they appear.

**How can I compare neighbourhoods on funda.nl by price per m²?**
Pull listings for several areas, then divide `priceValue` by `livingAreaSqm` per row. With `districtName`, `roomCount`, and `energyRating` alongside, you get a clean side-by-side read on where the value sits.

**How can I build a Netherlands real estate dataset for investment research?**
Feed in one or more search URLs, set `resultsLimit` to the volume you need, and export to CSV or Excel. The result is a structured property database (address, price, size, energy label, agent) you can score against your own buy criteria.

### Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

### Support

Questions, feature requests, or a field you'd like added? Reach out at <data.apify@proton.me> and we'll get back to you.

# Actor input Schema

## `targetUrls` (type: `array`):

One or more funda.nl search URLs to scrape. Each URL runs on its own with full pagination.

## `resultsLimit` (type: `integer`):

How many listings to pull per run.

## `timeoutSeconds` (type: `integer`):

Seconds to wait on each request before it times out.

## Actor input object example

```json
{
  "targetUrls": [
    "https://www.funda.nl/zoeken/koop/?selected_area=%5B%22rotterdam%22%5D"
  ],
  "resultsLimit": 15,
  "timeoutSeconds": 45
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "targetUrls": [
        "https://www.funda.nl/zoeken/koop/?selected_area=%5B%22rotterdam%22%5D"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("data_api/funda-property-scraper-cheap").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "targetUrls": ["https://www.funda.nl/zoeken/koop/?selected_area=%5B%22rotterdam%22%5D"] }

# Run the Actor and wait for it to finish
run = client.actor("data_api/funda-property-scraper-cheap").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 '{
  "targetUrls": [
    "https://www.funda.nl/zoeken/koop/?selected_area=%5B%22rotterdam%22%5D"
  ]
}' |
apify call data_api/funda-property-scraper-cheap --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=data_api/funda-property-scraper-cheap",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Funda Property Scraper (Cheap)",
        "description": "Funda property extractor that collects Dutch housing listings from funda.nl, so anyone tracking prices, comparing neighborhoods, or researching the Netherlands real estate market gets structured data fast.",
        "version": "0.0",
        "x-build-id": "j6b9fOONh0zGrMyyP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/data_api~funda-property-scraper-cheap/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-data_api-funda-property-scraper-cheap",
                "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/data_api~funda-property-scraper-cheap/runs": {
            "post": {
                "operationId": "runs-sync-data_api-funda-property-scraper-cheap",
                "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/data_api~funda-property-scraper-cheap/run-sync": {
            "post": {
                "operationId": "run-sync-data_api-funda-property-scraper-cheap",
                "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": [
                    "targetUrls"
                ],
                "properties": {
                    "targetUrls": {
                        "title": "Search URLs",
                        "type": "array",
                        "description": "One or more funda.nl search URLs to scrape. Each URL runs on its own with full pagination.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "resultsLimit": {
                        "title": "Results limit",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "How many listings to pull per run.",
                        "default": 15
                    },
                    "timeoutSeconds": {
                        "title": "Timeout (seconds)",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "Seconds to wait on each request before it times out.",
                        "default": 45
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
