Jaap 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.
What is the Jaap 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jaap-nl-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Huislijn SDK — search Dutch housing listings, drill into details."""
from parse_apis.huislijn_successor_to_jaap_nl_api import Huislijn, PropertyNotFound
client = Huislijn()
# Search for sale listings in Amsterdam — limit caps total items fetched.
for listing in client.salesearchresults.search(location="Amsterdam", limit=3):
print(listing.street, listing.price, listing.specs)
# Drill into one listing's full details via the typed navigation op.
listing = client.salesearchresults.search(location="Rotterdam", limit=1).first()
if listing:
detail = listing.details()
print(detail.title, detail.agent.name, detail.agent.phone)
print(f"Photos: {len(detail.photos)}, Characteristics: {len(detail.characteristics)}")
# Search rental listings.
for rental in client.rentalsearchresults.search(location="Utrecht", limit=3):
print(rental.street, rental.price, rental.url)
# Location autocomplete to resolve a query before searching.
for suggestion in client.suggestionresults.search(query="Den Haag", limit=3):
print(suggestion.name, suggestion.hits, suggestion.type)
# Typed error handling when a listing URL is invalid/removed.
try:
gone = client.propertydetails.get(url="https://www.huislijn.nl/koopwoning/nederland/noord-holland/0000000/nonexistent")
print(gone.title)
except PropertyNotFound as exc:
print(f"Property not found: {exc.url}")
print("exercised: salesearchresults.search / listing.details / rentalsearchresults.search / suggestionresults.search / propertydetails.get")
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. Paginates via integer page number.
| 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/4387136/welnastraat-293-amsterdam",
"price": "285000.00",
"specs": "Galerijflat",
"title": "Welnastraat 2931096GJ Amsterdam",
"street": "Welnastraat 293"
}
],
"total_pages": 1
},
"status": "success"
}
}About the Jaap API
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.
The Jaap API is a managed, monitored endpoint for jaap.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jaap.nl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jaap.nl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.