jaap.nl APIjaap.nl ↗
Access Dutch housing listings for sale and rent via the huislijn.nl API. Search by location, get property details, photos, agent info, and autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/7a9e3a9c-c056-47eb-b200-3bd54bd9cfd6/search_properties_for_sale?page=1&location=Amsterdam' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for properties for sale in the Netherlands. Returns paginated listing results with street address, price, property type, and listing URL. When no location is provided, returns listings from across the country.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| location | string | City, municipality, or region name to filter results (e.g. 'Amsterdam', 'Rotterdam'). Omitting returns nationwide listings. |
{
"type": "object",
"fields": {
"count": "integer number of listings on the current page",
"listings": "array of listing objects with street, title, price, specs, and url",
"total_pages": "integer total number of pages available"
},
"sample": {
"data": {
"count": 13,
"listings": [
{
"url": "https://www.huislijn.nl/koopwoning/nederland/noord-holland/4377177/sassenheimstraat-593-amsterdam",
"price": "689000.00",
"specs": "Bovenwoning",
"title": "Sassenheimstraat 5931059BD Amsterdam",
"street": "Sassenheimstraat 593"
}
],
"total_pages": 1
},
"status": "success"
}
}About the jaap.nl API
This API exposes 4 endpoints for querying Dutch residential property listings from huislijn.nl, the successor to jaap.nl. Use search_properties_for_sale or search_properties_for_rent to retrieve paginated listings across the Netherlands filtered by city or municipality, then call get_property_detail to pull full descriptions, photos, characteristics, and agent contact details for any individual listing.
Search and Filter Listings
Both search_properties_for_sale and search_properties_for_rent accept an optional location parameter (city, municipality, or region name such as 'Amsterdam' or 'Rotterdam') and an optional page integer for pagination. Each response returns a listings array of objects containing street, title, price, specs, and url, along with a count of results on the current page and total_pages so you can iterate through the full result set. Omitting location returns listings nationwide.
Property Detail
get_property_detail takes a full huislijn.nl listing URL and returns structured data for that property: a title (address and location), a description string, a characteristics object with key-value specification pairs (such as surface area, build year, and energy label), a photos array of image URLs, and an agent object containing the listing agent's name and phone number.
Location Autocomplete
get_search_suggestions accepts a query string and returns an items array of suggestion objects, each with a type (city, municipality, or street), name, hits (the number of matching listings), and geographic search fields. The original query string is echoed back in the response. This endpoint is useful for building location-aware search interfaces that match how users think about Dutch geography.
- Aggregate nationwide for-sale listings filtered by city to build a Dutch property search tool
- Monitor rental listing counts and prices across Dutch municipalities over time
- Extract agent contact details from
get_property_detailto build a broker directory - Pull
characteristicsdata (surface area, build year, energy label) for comparative property analysis - Collect
photosarrays from listing detail responses for visual property databases - Power a location autocomplete input using
get_search_suggestionswithhitscounts per suggestion - Build a price-per-region dataset by paginating through
search_properties_for_saleacross multiple locations
| 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 offer an official developer API?+
What does `get_property_detail` return beyond the search listing data?+
get_property_detail returns fields not present in search results: a full description text, a characteristics object with specification key-value pairs (e.g. living area, energy label, construction year), a photos array of image URLs, and an agent object with the listing agent's name and phone number.Can I filter listings by price range, number of rooms, or property type?+
location and page. Filtering by price, room count, or property type is not supported. You can fork this API on Parse and revise it to add those filter parameters.Does the API cover new-build (nieuwbouw) projects separately from existing homes?+
How does pagination work across the search endpoints?+
total_pages integer alongside the current page's count and listings. Pass the page parameter incrementally from 1 up to total_pages to retrieve the full result set for a given location query.