--- title: "Immovlan API: Search | Perceptlayer" description: "Search from Immovlan as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/immovlan/search --- [APIs](https://perceptlayer.com/apis) / [Immovlan](https://perceptlayer.com/apis/immovlan) / Search # Immovlan: Search Search from Immovlan as JSON. 1 credit per successful call. GET `/v1/immovlan/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `transaction` | string | Required | for-sale, for-rent, in-public-sale | | `agency_id` | integer | Optional | Any | | `sort` | string | Optional | price, bedrooms, area, zip | | `order` | string | Optional | asc, desc | | `page` | integer | Optional | Any | | `property_type[]` | list of string | Optional | house, apartment, land, garage, student-housing, business, investment-property, miscellaneous | | `property_subtype[]` | list of string | Optional | residence, villa, bungalow, chalet, cottage, master-house, mansion, mixed-building, land, development-site, to-parcel-out-site, farmland, other, green-zone, wood, recreational-land, industrial-ground, apartment, ground-floor, penthouse, duplex, triplex, studio, loft, garage, parking, student-flat, commercial-building, industrial-building, office-space, farming-site, business-surface, business-activity, investment-property, undetermined-property | | `epc_rating[]` | list of string | Optional | excellent, good, poor, bad, unknown | | `tag[]` | list of string | Optional | hasgarden, hasterrace, hasbalcony, hasswimmingpool, hasheatpump, hassolarpanels, hassolarthermicpanels, hasfloorheating, islowenergybuilding, hassauna, hashammam, hasgym, isfurnished, hasinternetconnection, hasfiberconnection, hascabletvconnection, hasdigitaltv, hasentryphone, hasoutsidesecuritygate, hasreinforcedgate, hasdisabledaccess, hasgarage, hascellar, isnew, isimportantupdate, hasvideo, hasvirtualvisit, arepetsallowed, isserviceappartement | | `facade[]` | list of string | Optional | 2, 3, 4 | | `state[]` | list of string | Optional | new, normal, excellent, to-be-renovated, fully-renovated | | `seller_type[]` | list of string | Optional | privateuser, prouser | | `municipal[]` | list of string | Optional | Any | | `town[]` | list of string | Optional | Any | | `province[]` | list of string | Optional | Any | | `region[]` | list of string | Optional | Any | | `price_min` | integer | Optional | Any | | `price_max` | integer | Optional | Any | | `bedrooms_min` | integer | Optional | Any | | `bedrooms_max` | integer | Optional | Any | | `bathrooms_min` | integer | Optional | Any | | `bathrooms_max` | integer | Optional | Any | | `area_min` | integer | Optional | Any | | `area_max` | integer | Optional | Any | | `plot_area_min` | integer | Optional | Any | | `plot_area_max` | integer | Optional | Any | ## Example request Immovlan GET /v1/immovlan/search?transaction=for-sale&sort=price&property\_type\[\]=apartment&province\[\]=antwerp&bedrooms\_min=2 ``` { "success": true, "data": { "transaction": "for-sale", "listings": [ { "id": "RBX01922", "property_id": 10769831, "agency_reference": "1241", "is_project": false, "status": "published", "transaction": "sale", "property_type": "apartment", "property_subtype": "penthouse", "title": "Penthouse for sale", "url": "https://immovlan.be/en/detail/penthouse/for-sale/2050/antwerp/rbx01922", "price": 95000, "display_price": "95 000 €", "currency": "EUR", "address": { "text": "2050 Antwerp", "zip": "2050", "city": "Antwerp", "country": "Belgium" }, "image": "https://api-image.immovlan.be/v1/property/RBX01922/thumbnail-webp/Medium?h=280", "description": "This unique penthouse investment opportunity in Antwerp is offered on a life annuity basis for €95,000. Situated in the residential area of Linkeroever, this spacious duplex apartment spans 143 m² across the 4th and 5th floors of the well-m…", "bedrooms": 3, "bathrooms": 2, "living_area": 143, "year_built": 1997, "published_at": "2026-09-28T09:14:36.000000+00:00", "highlights": [ { "key": "NrOfBedrooms", "label": "Bedroom(s)", "value": "3" }, { "key": "LivableSurface", "label": "m²", "value": "143" }, { "key": "NrOfBathrooms", "label": "Bathroom(s)", "value": "2" } ], "tags": [ "HasPicture", "HasGarage", "HasGarden" ], "has_epc": true, "price_recently_modified": false, "recently_modified": false, "agency": { "id": 40513, "name": "Immo2life", "type": "estateAgents", "logo": "https://api-image.immovlan.be/v1/prouser/01260440/logo/English/webp/Small", "phone": "+32 499 26 82 90" } }, { "id": "RBX31673", "property_id": 10815536, "agency_reference": "353678", "is_project": false, "status": "published", "transaction": "sale", "property_type": "apartment", "property_subtype": "flat", "title": "Apartment for sale", "url": "https://immovlan.be/en/detail/apartment/for-sale/2300/turnhout/rbx31673", "price": 139000, "display_price": "139 000 €", "currency": "EUR", "address": { "text": "2300 Turnhout", "zip": "2300", "city": "Turnhout", "country": "Belgium" }, "image": "https://api-image.immovlan.be/v1/property/RBX31673/thumbnail-webp/Medium?h=280", "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, individual utility meter…", "bedrooms": 2, "bathrooms": 1, "living_area": 82, "year_built": 1965, "published_at": "2026-11-05T00:45:45.000000+00:00", "highlights": [ { "key": "NrOfBedrooms", "label": "Bedroom(s)", "value": "2" }, { "key": "LivableSurface", "label": "m²", "value": "82" }, { "key": "TerraceSurface", "label": "Terrace", "value": "6 m²" } ], "proximity": [ { "category": "transports", "name": "Bus", "minutes": 1, "by_car": false }, { "category": "education", "name": "School", "minutes": 4, "by_car": false }, { "category": "shop", "name": "Shop", "minutes": 2, "by_car": false } ], "tags": [ "HasPicture", "HasTerrace", "HasGasConnection" ], "has_epc": true, "price_recently_modified": false, "recently_modified": true, "agency": { "id": 40407, "name": "Heylen Vastgoed Turnhout", "type": "estateAgents", "logo": "https://api-image.immovlan.be/v1/prouser/01267924/logo/English/webp/Small", "phone": "+32 14 73 38 82" } }, { "id": "RBV09598", "property_id": 10478354, "agency_reference": "41875", "is_project": false, "status": "published", "transaction": "sale", "property_type": "apartment", "property_subtype": "flat", "title": "Apartment for sale", "url": "https://immovlan.be/en/detail/apartment/for-sale/2400/mol/rbv09598", "price": 139900, "display_price": "139 900 €", "currency": "EUR", "address": { "text": "2400 Mol", "zip": "2400", "city": "Mol", "country": "Belgium" }, "image": "https://api-image.immovlan.be/v1/property/RBV09598/thumbnail-webp/Medium?h=280", "description": "Appartement - Appartement 4 is een appartement met alle nodige voorzieningen voor een fijn verblijf. Het is gelijkvloers en geschikt voor 4 personen. In de woonkamer vindt u een knusse zithoek met een televisie, een eethoek en een rijk uitg…", "bedrooms": 2, "bathrooms": 2, "published_at": "2026-01-25T21:47:07.000000+00:00", "highlights": [ { "key": "NrOfBedrooms", "label": "Bedroom(s)", "value": "2" }, { "key": "NrOfBathrooms", "label": "Bathroom(s)", "value": "2" } ], "proximity": [ { "category": "transports", "name": "Bus", "minutes": 14, "by_car": false }, { "category": "education", "name": "School", "minutes": 16, "by_car": false }, { "category": "shop", "name": "Shop", "minutes": 37, "by_car": false } ], "tags": [ "HasPicture", "HasTerrace" ], "has_epc": false, "price_recently_modified": false, "recently_modified": false, "agency": { "id": 47828, "name": "EuroParcs Verkoop", "type": "estateAgents", "logo": "https://api-image.immovlan.be/v1/prouser/SH19/logo/English/webp/Small" } } ], "count": 19, "total_count": 1026, "reachable_count": 1000, "page": 1, "size": 20, "total_pages": 50, "has_more": true, "filters_applied": { "transaction": "for-sale", "sort": "price", "order": "asc", "property_types": [ "apartment" ], "provinces": [ "antwerp" ], "bedrooms_min": 2 } }, "meta": { "endpoint_family": "search", "rows_removed_by_guard": 1, "duplicates_removed": 0, "request_id": "req_0c98458df2714489bd547eda78a54ad2", "credits_charged": 1, "credits_remaining": 1858 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/immovlan?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.