Skip to content
Examples

Get Results

Retrieve scraped data from Immoweb Listings & Phones Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Immoweb Listings & Phones Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

internal_idinteger

Unique identifier for the listing on Immoweb. Example: 10181065

urlstring

Direct URL to the listing on Immoweb. Example: https://www.immoweb.be/fr/annonce/10181065

typestring

Property type (e.g. APARTMENT, HOUSE). Example: APARTMENT

titlestring

Title of the listing. Example: Appartement 2 chambres

bedroom_countinteger

Number of bedrooms. Example: 2

localitystring

Locality/city of the property. Example: Evere

postal_codeinteger

Postal code of the property location. Example: 1140

streetstring

Street name of the property. Example: Rue Edouard Dekoster

numberstring

Street number of the property. Example: 64

boxstring

Box/unit number. Example: 40

floorinteger

Floor level of the property. Example: 1

latfloat

Latitude coordinate of the property. Example: 50.8782927

lngfloat

Longitude coordinate of the property. Example: 4.4040975

habitable_surfaceinteger

Habitable surface area in square meters. Example: 70

land_surfaceinteger

Land surface area in square meters. Example: 0

price_typestring

Type of price (e.g. residential_sale, residential_rent). Example: residential_sale

priceinteger

Listed price of the property. Example: 200000

bathroom_countinteger

Number of bathrooms. Example: 1

creation_datedatetime

Date the listing was created on Immoweb. Example: 2022-10-19

expiration_datedatetime

Date the listing expires on Immoweb. Example: 2023-02-27

last_modification_datedatetime

Date the listing was last modified. Example: 2022-10-19

agency_typestring

Type of agency (e.g. AGENCY, OWNER). Example: AGENCY

agency_emailstring

Email address of the agency. Example: contact@agency.be

agency_phonestring

Phone number of the agency. Example: +32 2 123 45 67

agency_mobilestring

Mobile phone number of the agency. Example: +32 478 15 73 6

agency_namestring

Name of the agency. Example: OM-IMMO SPRL

descriptiontext

Full property description text. Example: Magnifique appartement lumineux...

picturestring

URL of the main listing picture. Example: https://media-resize.immowebstatic.be/classifieds/.../736x736/image.jpg

picturestext

Comma-separated list of all picture URLs. Example: https://media-resize.immowebstatic.be/classifieds/.../736x736/img1.jpg, https://...

transaction_typestring

Transaction type (FOR_SALE, FOR_RENT). Example: FOR_SALE

countrystring

Country of the property. Example: Belgique

regionstring

Region of the property. Example: Bruxelles

provincestring

Province of the property. Example: Bruxelles

building_conditionstring

Building condition (AS_NEW, GOOD, TO_RENOVATE, etc.). Example: AS_NEW

facade_countinteger

Number of facades. Example: 2

floor_countinteger

Number of floors in the building. Example: 6

construction_yearinteger

Year the building was constructed. Example: 1950

has_liftboolean

Whether the building has an elevator. Example: true

has_terraceboolean

Whether the property has a terrace. Example: true

terrace_surfaceinteger

Terrace surface area in square meters. Example: 15

has_gardenboolean

Whether the property has a garden. Example: false

garden_surfaceinteger

Garden surface area in square meters. Example: 100

epc_scorestring

Energy Performance Certificate score. Example: C

heating_typestring

Heating type (GAS, ELECTRIC, OIL, etc.). Example: GAS

is_furnishedboolean

Whether the property is furnished. Example: false

external_referencestring

External reference number from the agency. Example: REF-12345

subtypestring

Property subtype (e.g. STUDIO, DUPLEX, PENTHOUSE). Example: APARTMENT

room_countinteger

Total number of rooms. Example: 4

sale_statusstring

Sale availability status (e.g. AVAILABLE, SOLD_OUT). Example: AVAILABLE

price_per_sqmfloat

Price per square meter. Example: 2857.14

old_priceinteger

Previous listed price, if reduced. Example: 220000

picture_countinteger

Total number of listing photos. Example: 12

unitsarray | null

Sub-unit breakdown for new-build projects. Each entry describes one apartment unit within the project. null for individual listings.

project_namestring | null

Name of the new-build project, if applicable. Example: Résidence Les Érables

project_sold_percentagefloat | null

Percentage of units already sold in a new-build project. Example: 65.0

carbon_emissionfloat | null

CO₂ emission rating in kg CO₂/sqm/year. Example: 18.5

primary_energy_consumptionfloat | null

Primary energy consumption in kWh/sqm/year. Example: 142.0

has_heat_pumpboolean

Whether the property has a heat pump. Example: false

has_photovoltaic_panelsboolean

Whether the property has solar (PV) panels. Example: false

has_double_glazingboolean

Whether the property has double-glazed windows. Example: true

has_asbestos_certificateboolean

Whether an asbestos certificate is present. Example: false

has_electrical_complianceboolean

Whether the electrical installation has a compliance certificate. Example: true

has_valid_flood_certificateboolean

Whether a valid flood-risk certificate is present. Example: true

oil_tank_certificate_statusstring | null

Status of the oil-tank certificate, if applicable. Example: COMPLIANT

kitchen_typestring

Kitchen type (e.g. INSTALLED, SEMI_EQUIPPED, NOT_INSTALLED). Example: INSTALLED

toilet_countinteger

Number of separate toilets. Example: 1

shower_room_countinteger

Number of shower rooms (separate from bathrooms). Example: 0

parking_count_indoorinteger

Number of indoor parking spaces included. Example: 1

parking_count_outdoorinteger

Number of outdoor parking spaces included. Example: 0

monthly_costsinteger | null

Monthly co-ownership charges in the listing currency. Example: 150

amenitiesarray

List of amenity strings reported on the listing. Example: ["BARBECUE", "BIKE_STORAGE"]

has_swimming_poolboolean

Whether the property has a swimming pool. Example: false

has_air_conditioningboolean

Whether the property has air conditioning. Example: false

has_disabled_accessboolean

Whether the property has disabled-access provisions. Example: false

has_internetboolean

Whether internet access is included. Example: false

has_alarmboolean

Whether the property has an alarm system. Example: false

view_countinteger

Number of times the listing has been viewed on Immoweb. Example: 847

bookmark_countinteger

Number of times the listing has been saved/bookmarked. Example: 23

agency_websitestring | null

Website URL of the agency. Example: https://www.agencyname.be

Response

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
}