docs / funda

Funda.nl API scraper

base /funda/v13 endpoints

post/funda/v1/search1 credit

Search Funda.nl property listings by area (for sale or for rent), with structured filters: price (EUR), rooms, living surface (m²), plot size, property type and sort. Each result carries price, object type, surface, rooms, bedrooms, energy label, construction type, address, agent and the primary photo. Paginate with page.

Parameter		Allowed / range	Description
area	required	—	Where to search — a Dutch city, town or province ('amsterdam', 'rotterdam', 'utrecht', 'den-haag', 'noord-holland'). Free text is accepted and resolved to Funda's area-slug automatically (a province is resolved to its provincie- slug).
contract = sale	optional	sale · rent	Listing type: for sale (koop) or for rent (huur). Rent prices are monthly.
home_type	optional	—	Property type — one or several comma-separated: house, apartment. e.g. 'house,apartment'.
sort = relevance	optional	relevance · newest · price_low · price_high · surface_high	Result ordering.
page = 1	optional	1–	Result page (15 listings per page; paginate with page += 1).
price_min	optional	0–	Minimum price in EUR (asking price for sale, monthly rent when contract=rent).
price_max	optional	0–	Maximum price in EUR.
rooms_min	optional	1–30	Minimum number of rooms.
rooms_max	optional	1–30	Maximum number of rooms.
surface_min	optional	0–	Minimum living surface in square metres (m²).
surface_max	optional	0–	Maximum living surface in square metres (m²).
plot_min	optional	0–	Minimum plot (land) size in square metres (m²).
plot_max	optional	0–	Maximum plot (land) size in square metres (m²).

Try in playground →

post/funda/v1/detail1 credit

Full record for a single listing by its Funda detail URL or path (funda.nl/detail/koop/<city>/<slug>/<id>/). Returns price, address, description, every photo at full resolution, and the complete Kenmerken (specifications) table — surface, rooms, year built, energy label, heating, location and more.

Parameter		Allowed / range	Description
url	required	—	A Funda listing detail URL or path — the funda.nl/detail/koop/<city>/<slug>/<id>/ link from a search result's `url`. A full https URL or just the /detail/... path both work.

Try in playground →

post/funda/v1/areafree

Area resolver — map a free-text Dutch place name to Funda's search area-slug and report the live listing count there. Use it to power a search box or to confirm the exact area the search will use (a city resolves to its slug, a province to its provincie- slug).

Parameter		Allowed / range	Description
query	required	—	Free-text Dutch place to resolve — a city, town or province ('Amsterdam', 'Den Haag', 'Noord-Holland').

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/funda/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"area":"amsterdam"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}