Immovlan Property Search API Search Immovlan homes, land, garages and business property for sale, for rent or in public sale in Belgium. Filter by location, property type, price, bedrooms, bathrooms, living area, plot area, energy rating, condition, facades, features and seller type, sort and page through the results.
Get location slugs from the autocomplete endpoint. An unknown slug is refused with a 422, because Immovlan would otherwise ignore it and return all of Belgium. Immovlan returns 20 listings per page and at most 50 pages, so a search reaches 1000 listings. Narrow it with more filters to reach the rest. total_count is the exact number Immovlan reports; reachable_count is the part you can page through.
New-build projects (is_project: true) show a price and area range and have no bedroom data. When a price, bedroom, bathroom or area filter is set, projects are left out because they cannot be checked, and meta.rows_removed_by_guard counts them. A page past the last page returns an empty page with the page number you asked for.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
25 optional filters available.
string
Required
for-sale, for-rent or in-public-sale.
example
string
Optional
One or more, comma separated: house, apartment, land, garage, student-housing, business, investment-property, miscellaneous.
example
string
Optional
One or more, comma separated, e.g. residence, villa, bungalow, penthouse, duplex, studio, loft, ground-floor, development-site.
example
string
Optional
Municipality slugs from the autocomplete endpoint (type municipality), comma separated, e.g. antwerp.
example
string
Optional
Town slugs from the autocomplete endpoint (type town), comma separated, e.g. 2018-antwerp.
example
string
Optional
Province slugs from the autocomplete endpoint, comma separated, e.g. antwerp.
example
string
Optional
Region slugs from the autocomplete endpoint, comma separated, e.g. brussels-region.
US
integer
Optional
Minimum price in EUR (monthly rent for for-rent).
10
integer
Optional
Maximum price in EUR (monthly rent for for-rent).
10
integer
Optional
Minimum bedrooms.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum bathrooms.
10
integer
Optional
Maximum bathrooms.
10
integer
Optional
Minimum living area in m2.
10
integer
Optional
Maximum living area in m2.
10
integer
Optional
Minimum total (plot) area in m2.
10
integer
Optional
Maximum total (plot) area in m2.
10
string
Optional
One or more, comma separated: excellent, good, poor, bad, unknown.
example
string
Optional
One or more, comma separated: new, normal, excellent, to-be-renovated, fully-renovated.
example
string
Optional
One or more, comma separated: 2, 3, 4.
example
string
Optional
Features that must all be present, comma separated, e.g. hasswimmingpool, hasgarden, hasterrace, hasgarage, isfurnished.
example
string
Optional
privateuser or prouser.
example
integer
Optional
Only listings of this agency (agency id from a search result).
1234567890
string
Optional
price, bedrooms, area (total area) or zip. Without it the Immovlan order is used.
relevance
string
Optional
asc or desc (default asc, only with sort).
example
integer
Optional
Page number, 1 to 50 (default 1). 20 listings per page, so results stop at 1000.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"size": 20,
"count": 19,
"has_more": true,
"listings": [
{
"id": "RBX01922",
"url": "https://immovlan.be/en/detail/penthouse/for-sale/2050/antwerp/rbx01922",
"tags": [
"HasPicture",
"HasGarage",
"HasGarden",
"HasTerrace",
"HasHeatPump",
"HasWaterConnection",
"HasEpcCertificate",
"IsLifeAnnuity",
"HasAttic"
],
"image": "https://api-image.immovlan.be/v1/property/RBX01922/thumbnail-webp/Medium?h=280",
"price": 95000,
"title": "Penthouse for sale",
"agency": {
"id": 40513,
"logo": "https://api-image.immovlan.be/v1/prouser/01260440/logo/English/webp/Small",
"name": "Immo2life",
"type": "estateAgents",
"phone": "+32 499 26 82 90"
},
"status": "published",
"address": {
"zip": "2050",
"city": "Antwerp",
"text": "2050 Antwerp",
"country": "Belgium"
},
"has_epc": true,
"bedrooms": 3,
"currency": "EUR",
"price_to": null,
"bathrooms": 2,
"proximity": [],
"highlights": [
{
"key": "NrOfBedrooms",
"label": "Bedroom(s)",
"value": "3"
},
{
"key": "LivableSurface",
"label": "m\u00b2",
"value": "143"
},
{
"key": "NrOfBathrooms",
"label": "Bathroom(s)",
"value": "2"
}
],
"is_project": false,
"price_from": null,
"year_built": 1997,
"description": "This unique penthouse investment opportunity in Antwerp is offered on a life annuity basis for \u20ac95,000. Situated in the residential area of Linkeroever, this spacious duplex apartment spans 143 m\u00b2 across the 4th and 5...",
"living_area": 143,
"property_id": 10769831,
"transaction": "sale",
"published_at": "2026-09-28T09:14:36.000000+00:00",
"display_price": "95 000 \u20ac",
"property_type": "appartment",
"agency_reference": "1241",
"property_subtype": "penthouse",
"living_area_range": null,
"recently_modified": false,
"price_recently_modified": false
},
{
"id": "RBX14437",
"url": "https://immovlan.be/en/detail/apartment/for-sale/2300/turnhout/rbx14437",
"tags": [
"HasPicture",
"HasTerrace",
"HasGasConnection",
"HasWaterConnection",
"HasEpcCertificate",
"IsUpdate"
],
"image": "https://api-image.immovlan.be/v1/property/RBX14437/thumbnail-webp/Medium?h=280",
"price": 139000,
"title": "Apartment for sale",
"agency": {
"id": 40407,
"logo": "https://api-image.immovlan.be/v1/prouser/01267924/logo/English/webp/Small",
"name": "Heylen Vastgoed Turnhout",
"type": "estateAgents",
"phone": "+32 14 73 38 82"
},
"status": "option",
"address": {
"zip": "2300",
"city": "Turnhout",
"text": "2300 Turnhout",
"country": "Belgium"
},
"has_epc": true,
"bedrooms": 2,
"currency": "EUR",
"price_to": null,
"bathrooms": 1,
"proximity": [
{
"name": "Bus",
"by_car": false,
"minutes": 1,
"category": "transports"
},
{
"name": "School",
"by_car": false,
"minutes": 4,
"category": "education"
},
{
"name": "Shop",
"by_car": false,
"minutes": 2,
"category": "shop"
}
],
"highlights": [
{
"key": "NrOfBedrooms",
"label": "Bedroom(s)",
"value": "2"
},
{
"key": "LivableSurface",
"label": "m\u00b2",
"value": "82"
},
{
"key": "TerraceSurface",
"label": "Terrace",
"value": "6 m\u00b2"
},
{
"key": "NrOfBathrooms",
"label": "Bathroom(s)",
"value": "1"
}
],
"is_project": false,
"price_from": null,
"year_built": 1965,
"description": "2-Bedroom Apartment with Terrace This 2-bedroom apartment with a terrace is centrally located in Turnhout and offers an attractive opportunity for both owner-occupancy and investment. Thanks to its practical layout, i...",
"living_area": 82,
"property_id": 10787985,
"transaction": "sale",
"published_at": "2026-10-10T20:57:16.000000+00:00",
"display_price": "139 000 \u20ac",
"property_type": "appartment",
"agency_reference": "341381",
"property_subtype": "flat",
"living_area_range": null,
"recently_modified": true,
"price_recently_modified": false
}
],
"total_count": 975,
"total_pages": 49,
"transaction": "for-sale",
"filters_applied": {
"sort": "price",
"order": "asc",
"provinces": [
"antwerp"
],
"transaction": "for-sale",
"bedrooms_min": 2,
"property_types": [
"apartment"
]
},
"reachable_count": 975
},
"meta": {
"billable": true,
"endpoint_family": "search",
"duplicates_removed": 0,
"rows_removed_by_guard": 1
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter is missing or invalid. This response is not billable.
{
"errors": {
"transaction": [
"The transaction is required: for-sale, for-rent or in-public-sale."
]
},
"message": "The request validation failed"
}Unprocessable Entity
A location slug is not known to Immovlan. Use slugs from the autocomplete endpoint. This response is not billable.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false
},
"error": {
"message": "One or more location slugs are not known to Immovlan. Get valid slugs from the autocomplete endpoint.",
"failure_type": "unknown_location"
},
"success": false
}Service Unavailable
Immovlan could not be reached or returned an unreadable page after retries. Retry shortly. This response is not billable.
{
"meta": {
"attempts": 3,
"billable": false,
"retryable": true
},
"error": {
"message": "Immovlan data is temporarily unavailable. Please retry.",
"failure_type": "upstream_unavailable"
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.