Funda sale and rent search on www.funda.nl.
query is a place or a search URL. offering is koop (sale) or huur (rent). page starts at 1 and is sent to Funda as search_result.
price is the asking price in euros, or the monthly rent. price_display is the card text, such as € 565.000 k.k. or € 4.250 p.m.. currency is EUR when a price is present. There is no previous or struck price.
The response is { results, pagination }. Page 1 and page 2 list different homes.
GET https://api.piloterr.com/v2/funda/search?query=amsterdam
GET https://api.piloterr.com/v2/funda/search?query=amsterdam&offering=koop
GET https://api.piloterr.com/v2/funda/search?query=amsterdam&offering=huur
GET https://api.piloterr.com/v2/funda/search?query=amsterdam&page=2
GET https://api.piloterr.com/v2/funda/search?query=https://www.funda.nl/zoeken/koop/?selected_area=amsterdam
| Parameter |
Type |
Required |
Example |
query |
string |
yes |
amsterdam |
offering |
string |
no |
koop or huur |
page |
integer |
no |
2 |
A search URL keeps /zoeken/koop/ or /zoeken/huur/. A listing URL returns 400. A page with no listings returns 404.
| Field |
Type |
Description |
results |
array |
One object per listing |
results[].id |
integer |
Id from the listing URL |
results[].url |
string |
Listing URL |
results[].title |
string |
Street and house number |
results[].price |
integer or null |
Asking price or monthly rent, in euros |
results[].price_display |
string or null |
Price as shown, for example € 565.000 k.k. |
results[].currency |
string or null |
EUR when a price is present |
results[].offering_type |
string |
koop or huur |
results[].bedrooms |
integer |
Bedroom count |
results[].floor_area |
integer |
Living area in m² |
results[].energy_label |
string |
Energy label |
results[].agent |
object |
Agency name, URL, and logo |
pagination.page |
integer |
Current page |
pagination.per_page |
integer |
15 |
pagination.total_results |
integer |
Matching listings |
pagination.total_pages |
integer |
Page count |
pagination.next |
string or null |
Next Funda URL |
- Watch Amsterdam sale prices
- Collect rental ads in The Hague
- Take a listing id into Property
| Code |
Meaning |
| 400 |
Missing query, unknown offering, page below 1, bad domain, or a listing URL |
| 401 |
Missing API key |
| 404 |
No listings |
| 500 |
Render or parse failure |
Funda Property