# Funda Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/funda/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/funda-search | ## Description Search Funda by place. Set offering to koop for sale or huur for rent, then page the listings. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/funda/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Amsterdam koop, Hillegomstraat 57-1 ```json { "results": [ { "id": 44654106, "url": "https://www.funda.nl/detail/koop/amsterdam/appartement-hillegomstraat-57-1/44654106/", "city": "Amsterdam", "agent": { "id": 24575, "url": "https://www.funda.nl/makelaar/24575-aw-sabel-makelaardij-og/", "logo": "https://cloud.funda.nl/valentina_media/141/983/997.jpg", "name": "A.W. Sabel Makelaardij o.g.", "association": "NVM", "contact_name": null, "contact_image": null }, "image": "https://cloud.funda.nl/tiara-media/4d4baf74-f6c7-4d23-85d6-7a031ab7b45c/fccdebc5-cc6a-477e-97e2-32651664f739?options=width=720", "price": 565000, "rooms": 3, "title": "Hillegomstraat 57-1", "images": [ "https://cloud.funda.nl/tiara-media/4d4baf74-f6c7-4d23-85d6-7a031ab7b45c/fccdebc5-cc6a-477e-97e2-32651664f739?options=width=720", "https://cloud.funda.nl/tiara-media/4d4baf74-f6c7-4d23-85d6-7a031ab7b45c/fdb09cc2-b7a5-48d9-9243-455de8545155?options=width=720", "https://cloud.funda.nl/tiara-media/4d4baf74-f6c7-4d23-85d6-7a031ab7b45c/88438efd-80b7-4838-b423-9cf7b52c5ec5?options=width=720" ], "street": "Hillegomstraat", "zoning": "residential", "country": "NL", "bedrooms": 2, "currency": "EUR", "district": "Hoofddorppleinbuurt", "province": "Noord-Holland", "global_id": 8209743, "plot_area": null, "floor_area": 60, "price_type": "regular", "promo_text": "Sfeervol appartement met verdiept balkon in de Hoofdorppleinbuurt!", "media_types": [ "floor_plan", "photo_360", "video" ], "object_type": "apartment", "postal_code": "1058 LR", "energy_label": "D", "house_number": "57", "listing_type": "single", "municipality": "Amsterdam", "publish_date": "2026-10-29T15:19:55.3584664+01:00", "neighbourhood": "Westlandgrachtbuurt", "offering_type": "koop", "price_display": "€ 565.000 k.k.", "price_condition": "kosten_koper", "construction_type": "resale", "house_number_suffix": "1" } ], "pagination": { "next": "https://www.funda.nl/zoeken/koop/?selected_area=amsterdam&search_result=2", "page": 1, "per_page": 15, "total_pages": 467, "total_results": 7003 } } ``` ## Documentation ## Overview 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. ## Quickstart ``` 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 ``` ## Parameters | 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. ## Response fields | 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 | ## Main use cases - Watch Amsterdam sale prices - Collect rental ads in The Hague - Take a listing id into Property ## Error codes | 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 | ## Related endpoints [Funda Property](https://www.piloterr.com/library/funda-property)