huislijn.nl APIhuislijn.nl ↗
Search for-sale and rental housing listings on huislijn.nl. Access property details, agent info, price filters, and newest listings via 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/e8375b0e-b4de-4593-b13e-8e5a50e987c7/search_for_sale_listings?page=1&price_to=500000&price_from=200000' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for homes for sale in the Netherlands with optional price filters. Returns paginated listing results extracted from huislijn.nl.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| price_to | integer | Maximum price filter in EUR. |
| price_from | integer | Minimum price filter in EUR. |
{
"type": "object",
"fields": {
"url": "string, the URL that was queried",
"page": "integer, current page number",
"listings": "array of property listing objects with id, type, link, street, city, price, photo, properties, location",
"total_results": "integer or null, total number of matching listings"
},
"sample": {
"data": {
"url": "https://www.huislijn.nl/koopwoning/nederland?page=1&c-priceFrom=200000&c-priceTo=500000",
"page": 1,
"listings": [
{
"id": 4368179,
"city": "Amerongen",
"link": "/koopwoning/nederland/utrecht/4368179/holleweg-19-amerongen",
"type": "sale",
"price": "725000.00",
"status": "Beschikbaar",
"street": "Holleweg",
"zipcode": "3958EA",
"housenumber": "19"
}
],
"total_results": null
},
"status": "success"
}
}About the huislijn.nl API
The huislijn.nl API provides access to Dutch property listings across 3 endpoints, covering for-sale homes, rental properties, and detailed listing pages. The search_for_sale_listings endpoint accepts price range filters and returns paginated results including street, city, price, photo, and location data for each property. Use get_listing_detail to pull full feature sets, agent contact info, and similar nearby properties for any individual listing.
Endpoints and Data Coverage
The API exposes three endpoints targeting the huislijn.nl housing platform. search_for_sale_listings accepts optional price_from and price_to integer filters (in EUR) and a page parameter for pagination. Each result object in the listings array includes a property id, type, link, street, city, price, photo, a properties field with structured attributes, and a location object. The total_results field indicates the full count of matching listings, which is useful for calculating total pages.
Listing Detail and Agent Data
get_listing_detail takes a URL path (e.g. /koopwoning/nederland/provincie/1234567/straatnaam-huisnummer-stad) and returns the full listing page data: a title, a features object grouped by category such as Algemeen and Woningdetails, an optional description string, an agent object with the agent's name and url, and a similar_listings array with titles and links to nearby properties. This endpoint is the primary way to retrieve structured feature data like floor area, energy label, or construction year.
Newest Listings Feed
get_newest_listings retrieves recently added properties using a days parameter expressed as a negative integer string — for example, '-3' returns listings from the past 3 days and '-7' returns the past week. A type parameter filters results to either 'sale' or 'rent'. The response shares the same listing object shape as search_for_sale_listings, making it straightforward to handle both endpoints with a single data model. total_results here reflects the actual count returned rather than a broader match set.
- Monitor newly listed rental properties in the Netherlands using the
dayslookback filter inget_newest_listings. - Build a price-band search tool that filters Dutch for-sale homes by
price_fromandprice_toparameters. - Aggregate agent listings by extracting the
agent.nameandagent.urlfields fromget_listing_detailacross multiple properties. - Display property feature cards using structured
featurescategories likeWoningdetailsreturned from the detail endpoint. - Power a neighborhood comparison tool using
cityandlocationfields from paginatedsearch_for_sale_listingsresults. - Track market activity by logging
total_resultscounts from for-sale searches over time. - Surface similar properties alongside a listing using the
similar_listingsarray fromget_listing_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does huislijn.nl have an official developer API?+
What does `get_listing_detail` return in the `features` field?+
features field is an object whose keys are category names as they appear on the listing page, such as Algemeen and Woningdetails. Each category maps to a set of key-value pairs covering attributes like surface area, number of rooms, energy label, and construction year. The exact keys present vary by listing type and how the property was entered by the agent.Can I search rental listings with price filters the same way I search for-sale listings?+
search_for_sale_listings endpoint with price_from and price_to filters covers only for-sale properties. Rental listings are accessible via get_newest_listings with type set to 'rent', but that endpoint does not currently support price range filtering. You can fork this API on Parse and revise it to add a dedicated rental search endpoint with price parameters.How far back does `get_newest_listings` go?+
days parameter controls the lookback window and is passed as a negative integer string such as '-7' for the past week or '-30' for the past month. There is no documented hard limit on the lookback range, but very large windows may return large result sets or incomplete data depending on platform availability.Does the API return floor plan images or virtual tour links from listing pages?+
get_listing_detail returns a photo reference at the listing level and structured features text, but additional media assets are not part of the response schema. You can fork this API on Parse and revise it to add media asset extraction if those fields are needed.