Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"internal_id": 123,
"url": "<string>",
"type": "<string>",
"title": "<string>",
"bedroom_count": 123,
"locality": "<string>",
"postal_code": 123,
"street": "<string>",
"number": "<string>",
"box": "<string>",
"floor": 123,
"lat": 123,
"lng": 123,
"habitable_surface": 123,
"land_surface": 123,
"price_type": "<string>",
"price": 123,
"bathroom_count": 123,
"creation_date": {},
"expiration_date": {},
"last_modification_date": {},
"agency_type": "<string>",
"agency_email": "<string>",
"agency_phone": "<string>",
"agency_mobile": "<string>",
"agency_name": "<string>",
"description": "<string>",
"picture": "<string>",
"pictures": "<string>",
"transaction_type": "<string>",
"country": "<string>",
"region": "<string>",
"province": "<string>",
"building_condition": "<string>",
"facade_count": 123,
"floor_count": 123,
"construction_year": 123,
"has_lift": true,
"has_terrace": true,
"terrace_surface": 123,
"has_garden": true,
"garden_surface": 123,
"epc_score": "<string>",
"heating_type": "<string>",
"is_furnished": true,
"external_reference": "<string>",
"subtype": "<string>",
"room_count": 123,
"sale_status": "<string>",
"price_per_sqm": 123,
"old_price": 123,
"picture_count": 123,
"units": {},
"project_name": {},
"project_sold_percentage": {},
"carbon_emission": {},
"primary_energy_consumption": {},
"has_heat_pump": true,
"has_photovoltaic_panels": true,
"has_double_glazing": true,
"has_asbestos_certificate": true,
"has_electrical_compliance": true,
"has_valid_flood_certificate": true,
"oil_tank_certificate_status": {},
"kitchen_type": "<string>",
"toilet_count": 123,
"shower_room_count": 123,
"parking_count_indoor": 123,
"parking_count_outdoor": 123,
"monthly_costs": {},
"amenities": [
{}
],
"has_swimming_pool": true,
"has_air_conditioning": true,
"has_disabled_access": true,
"has_internet": true,
"has_alarm": true,
"view_count": 123,
"bookmark_count": 123,
"agency_website": {}
}Immoweb Listings & Phone Search Export
Get Results
Retrieve scraped data from Immoweb Listings & Phones Search Export
GET
/
v1
/
results
Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"internal_id": 123,
"url": "<string>",
"type": "<string>",
"title": "<string>",
"bedroom_count": 123,
"locality": "<string>",
"postal_code": 123,
"street": "<string>",
"number": "<string>",
"box": "<string>",
"floor": 123,
"lat": 123,
"lng": 123,
"habitable_surface": 123,
"land_surface": 123,
"price_type": "<string>",
"price": 123,
"bathroom_count": 123,
"creation_date": {},
"expiration_date": {},
"last_modification_date": {},
"agency_type": "<string>",
"agency_email": "<string>",
"agency_phone": "<string>",
"agency_mobile": "<string>",
"agency_name": "<string>",
"description": "<string>",
"picture": "<string>",
"pictures": "<string>",
"transaction_type": "<string>",
"country": "<string>",
"region": "<string>",
"province": "<string>",
"building_condition": "<string>",
"facade_count": 123,
"floor_count": 123,
"construction_year": 123,
"has_lift": true,
"has_terrace": true,
"terrace_surface": 123,
"has_garden": true,
"garden_surface": 123,
"epc_score": "<string>",
"heating_type": "<string>",
"is_furnished": true,
"external_reference": "<string>",
"subtype": "<string>",
"room_count": 123,
"sale_status": "<string>",
"price_per_sqm": 123,
"old_price": 123,
"picture_count": 123,
"units": {},
"project_name": {},
"project_sold_percentage": {},
"carbon_emission": {},
"primary_energy_consumption": {},
"has_heat_pump": true,
"has_photovoltaic_panels": true,
"has_double_glazing": true,
"has_asbestos_certificate": true,
"has_electrical_compliance": true,
"has_valid_flood_certificate": true,
"oil_tank_certificate_status": {},
"kitchen_type": "<string>",
"toilet_count": 123,
"shower_room_count": 123,
"parking_count_indoor": 123,
"parking_count_outdoor": 123,
"monthly_costs": {},
"amenities": [
{}
],
"has_swimming_pool": true,
"has_air_conditioning": true,
"has_disabled_access": true,
"has_internet": true,
"has_alarm": true,
"view_count": 123,
"bookmark_count": 123,
"agency_website": {}
}Retrieve scraped data from your Immoweb Listings & Phones Search Export runs.
Headers
string
required
Your API authentication token. Value:
Token YOUR_API_KEYQuery Parameters
string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example:
1Result Fields
Each result object contains the following fields:integer
Unique identifier for the listing on Immoweb. Example:
10181065string
Direct URL to the listing on Immoweb. Example:
https://www.immoweb.be/fr/annonce/10181065string
Property type (e.g. APARTMENT, HOUSE). Example:
APARTMENTstring
Title of the listing. Example:
Appartement 2 chambresinteger
Number of bedrooms. Example:
2string
Locality/city of the property. Example:
Evereinteger
Postal code of the property location. Example:
1140string
Street name of the property. Example:
Rue Edouard Dekosterstring
Street number of the property. Example:
64string
Box/unit number. Example:
40integer
Floor level of the property. Example:
1float
Latitude coordinate of the property. Example:
50.8782927float
Longitude coordinate of the property. Example:
4.4040975integer
Habitable surface area in square meters. Example:
70integer
Land surface area in square meters. Example:
0string
Type of price (e.g. residential_sale, residential_rent). Example:
residential_saleinteger
Listed price of the property. Example:
200000integer
Number of bathrooms. Example:
1datetime
Date the listing was created on Immoweb. Example:
2022-10-19datetime
Date the listing expires on Immoweb. Example:
2023-02-27datetime
Date the listing was last modified. Example:
2022-10-19string
Type of agency (e.g. AGENCY, OWNER). Example:
AGENCYstring
Email address of the agency. Example:
contact@agency.bestring
Phone number of the agency. Example:
+32 2 123 45 67string
Mobile phone number of the agency. Example:
+32 478 15 73 6string
Name of the agency. Example:
OM-IMMO SPRLtext
Full property description text. Example:
Magnifique appartement lumineux...string
URL of the main listing picture. Example:
https://media-resize.immowebstatic.be/classifieds/.../736x736/image.jpgtext
Comma-separated list of all picture URLs. Example:
https://media-resize.immowebstatic.be/classifieds/.../736x736/img1.jpg, https://...string
Transaction type (FOR_SALE, FOR_RENT). Example:
FOR_SALEstring
Country of the property. Example:
Belgiquestring
Region of the property. Example:
Bruxellesstring
Province of the property. Example:
Bruxellesstring
Building condition (AS_NEW, GOOD, TO_RENOVATE, etc.). Example:
AS_NEWinteger
Number of facades. Example:
2integer
Number of floors in the building. Example:
6integer
Year the building was constructed. Example:
1950boolean
Whether the building has an elevator. Example:
trueboolean
Whether the property has a terrace. Example:
trueinteger
Terrace surface area in square meters. Example:
15boolean
Whether the property has a garden. Example:
falseinteger
Garden surface area in square meters. Example:
100string
Energy Performance Certificate score. Example:
Cstring
Heating type (GAS, ELECTRIC, OIL, etc.). Example:
GASboolean
Whether the property is furnished. Example:
falsestring
External reference number from the agency. Example:
REF-12345string
Property subtype (e.g. STUDIO, DUPLEX, PENTHOUSE). Example:
APARTMENTinteger
Total number of rooms. Example:
4string
Sale availability status (e.g. AVAILABLE, SOLD_OUT). Example:
AVAILABLEfloat
Price per square meter. Example:
2857.14integer
Previous listed price, if reduced. Example:
220000integer
Total number of listing photos. Example:
12array | null
Sub-unit breakdown for new-build projects. Each entry describes one apartment unit within the project.
null for individual listings.string | null
Name of the new-build project, if applicable. Example:
Résidence Les Érablesfloat | null
Percentage of units already sold in a new-build project. Example:
65.0float | null
CO₂ emission rating in kg CO₂/sqm/year. Example:
18.5float | null
Primary energy consumption in kWh/sqm/year. Example:
142.0boolean
Whether the property has a heat pump. Example:
falseboolean
Whether the property has solar (PV) panels. Example:
falseboolean
Whether the property has double-glazed windows. Example:
trueboolean
Whether an asbestos certificate is present. Example:
falseboolean
Whether the electrical installation has a compliance certificate. Example:
trueboolean
Whether a valid flood-risk certificate is present. Example:
truestring | null
Status of the oil-tank certificate, if applicable. Example:
COMPLIANTstring
Kitchen type (e.g. INSTALLED, SEMI_EQUIPPED, NOT_INSTALLED). Example:
INSTALLEDinteger
Number of separate toilets. Example:
1integer
Number of shower rooms (separate from bathrooms). Example:
0integer
Number of indoor parking spaces included. Example:
1integer
Number of outdoor parking spaces included. Example:
0integer | null
Monthly co-ownership charges in the listing currency. Example:
150array
List of amenity strings reported on the listing. Example:
["BARBECUE", "BIKE_STORAGE"]boolean
Whether the property has a swimming pool. Example:
falseboolean
Whether the property has air conditioning. Example:
falseboolean
Whether the property has disabled-access provisions. Example:
falseboolean
Whether internet access is included. Example:
falseboolean
Whether the property has an alarm system. Example:
falseinteger
Number of times the listing has been viewed on Immoweb. Example:
847integer
Number of times the listing has been saved/bookmarked. Example:
23string | null
Website URL of the agency. Example:
https://www.agencyname.beResponse
200
{
"total_results": 1,
"limit": 50,
"page": 1,
"total_pages": 1,
"result_from": 1,
"result_to": 1,
"data": [
{
"id": 34737,
"object": "result",
"squid": "87559da1c8f64d80b00b6e86ff597b60",
"run": "fad94d6642ac9f41ea9c6762e5d77a6d",
"internal_id": 10181065,
"url": "https://www.immoweb.be/fr/annonce/10181065",
"type": "APARTMENT",
"title": "Appartement 2 chambres",
"bedroom_count": 2,
"locality": "Evere",
"postal_code": 1140,
"street": "Rue Edouard Dekoster",
"number": "64",
"box": "40",
"floor": 1,
"lat": 50.8782927,
"lng": 4.4040975,
"habitable_surface": 70,
"land_surface": 0,
"price_type": "residential_sale",
"price": 200000,
"bathroom_count": 1,
"creation_date": "2022-10-19",
"expiration_date": "2023-02-27",
"last_modification_date": "2022-10-19",
"agency_type": "AGENCY",
"agency_email": "contact@agency.be",
"agency_phone": "+32 2 123 45 67",
"agency_mobile": "+32 478 15 73 6",
"agency_name": "OM-IMMO SPRL",
"description": "Magnifique appartement lumineux...",
"picture": "https://media-resize.immowebstatic.be/classifieds/.../736x736/image.jpg",
"pictures": "https://media-resize.immowebstatic.be/classifieds/.../736x736/img1.jpg, https://...",
"transaction_type": "FOR_SALE",
"country": "Belgique",
"region": "Bruxelles",
"province": "Bruxelles",
"building_condition": "AS_NEW",
"facade_count": 2,
"floor_count": 6,
"construction_year": 1950,
"has_lift": true,
"has_terrace": true,
"terrace_surface": 15,
"has_garden": false,
"garden_surface": 100,
"epc_score": "C",
"heating_type": "GAS",
"is_furnished": false,
"external_reference": "REF-12345",
"subtype": "APARTMENT",
"room_count": 4,
"sale_status": "available",
"price_per_sqm": 3200,
"old_price": 210000,
"picture_count": 13,
"units": [
{
"id": 21781288,
"price": 299000,
"surface": 72,
"bedroom_count": 1,
"floor": 2,
"sale_status": "AVAILABLE"
}
],
"project_name": "ALBA",
"project_sold_percentage": 40,
"carbon_emission": 56,
"primary_energy_consumption": 20634,
"has_heat_pump": false,
"has_photovoltaic_panels": true,
"has_double_glazing": true,
"has_asbestos_certificate": false,
"has_electrical_compliance": true,
"has_valid_flood_certificate": true,
"oil_tank_certificate_status": "GREEN",
"kitchen_type": "SEMI_EQUIPPED",
"toilet_count": 1,
"shower_room_count": 1,
"parking_count_indoor": 1,
"parking_count_outdoor": 0,
"monthly_costs": 75,
"amenities": {
"lift": true,
"terrace": true,
"swimming_pool": false
},
"has_swimming_pool": false,
"has_air_conditioning": false,
"has_disabled_access": false,
"has_internet": true,
"has_alarm": false,
"view_count": 128,
"bookmark_count": 4,
"agency_website": "http://www.agency.be",
"functions": null,
"native_id": 34737
}
],
"next": null,
"previous": null
}