# Get Results

Retrieve scraped data from Immoweb Listings & Phones Search Export

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

## Headers
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields
Each result object contains the following fields:

<ResponseField name="internal_id" type="integer">
  Unique identifier for the listing on Immoweb. Example: `10181065`
</ResponseField>

<ResponseField name="url" type="string">
  Direct URL to the listing on Immoweb. Example: `https://www.immoweb.be/fr/annonce/10181065`
</ResponseField>

<ResponseField name="type" type="string">
  Property type (e.g. APARTMENT, HOUSE). Example: `APARTMENT`
</ResponseField>

<ResponseField name="title" type="string">
  Title of the listing. Example: `Appartement 2 chambres`
</ResponseField>

<ResponseField name="bedroom_count" type="integer">
  Number of bedrooms. Example: `2`
</ResponseField>

<ResponseField name="locality" type="string">
  Locality/city of the property. Example: `Evere`
</ResponseField>

<ResponseField name="postal_code" type="integer">
  Postal code of the property location. Example: `1140`
</ResponseField>

<ResponseField name="street" type="string">
  Street name of the property. Example: `Rue Edouard Dekoster`
</ResponseField>

<ResponseField name="number" type="string">
  Street number of the property. Example: `64`
</ResponseField>

<ResponseField name="box" type="string">
  Box/unit number. Example: `40`
</ResponseField>

<ResponseField name="floor" type="integer">
  Floor level of the property. Example: `1`
</ResponseField>

<ResponseField name="lat" type="float">
  Latitude coordinate of the property. Example: `50.8782927`
</ResponseField>

<ResponseField name="lng" type="float">
  Longitude coordinate of the property. Example: `4.4040975`
</ResponseField>

<ResponseField name="habitable_surface" type="integer">
  Habitable surface area in square meters. Example: `70`
</ResponseField>

<ResponseField name="land_surface" type="integer">
  Land surface area in square meters. Example: `0`
</ResponseField>

<ResponseField name="price_type" type="string">
  Type of price (e.g. residential_sale, residential_rent). Example: `residential_sale`
</ResponseField>

<ResponseField name="price" type="integer">
  Listed price of the property. Example: `200000`
</ResponseField>

<ResponseField name="bathroom_count" type="integer">
  Number of bathrooms. Example: `1`
</ResponseField>

<ResponseField name="creation_date" type="datetime">
  Date the listing was created on Immoweb. Example: `2022-10-19`
</ResponseField>

<ResponseField name="expiration_date" type="datetime">
  Date the listing expires on Immoweb. Example: `2023-02-27`
</ResponseField>

<ResponseField name="last_modification_date" type="datetime">
  Date the listing was last modified. Example: `2022-10-19`
</ResponseField>

<ResponseField name="agency_type" type="string">
  Type of agency (e.g. AGENCY, OWNER). Example: `AGENCY`
</ResponseField>

<ResponseField name="agency_email" type="string">
  Email address of the agency. Example: `contact@agency.be`
</ResponseField>

<ResponseField name="agency_phone" type="string">
  Phone number of the agency. Example: `+32 2 123 45 67`
</ResponseField>

<ResponseField name="agency_mobile" type="string">
  Mobile phone number of the agency. Example: `+32 478 15 73 6`
</ResponseField>

<ResponseField name="agency_name" type="string">
  Name of the agency. Example: `OM-IMMO SPRL`
</ResponseField>

<ResponseField name="description" type="text">
  Full property description text. Example: `Magnifique appartement lumineux...`
</ResponseField>

<ResponseField name="picture" type="string">
  URL of the main listing picture. Example: `https://media-resize.immowebstatic.be/classifieds/.../736x736/image.jpg`
</ResponseField>

<ResponseField name="pictures" type="text">
  Comma-separated list of all picture URLs. Example: `https://media-resize.immowebstatic.be/classifieds/.../736x736/img1.jpg, https://...`
</ResponseField>

<ResponseField name="transaction_type" type="string">
  Transaction type (FOR_SALE, FOR_RENT). Example: `FOR_SALE`
</ResponseField>

<ResponseField name="country" type="string">
  Country of the property. Example: `Belgique`
</ResponseField>

<ResponseField name="region" type="string">
  Region of the property. Example: `Bruxelles`
</ResponseField>

<ResponseField name="province" type="string">
  Province of the property. Example: `Bruxelles`
</ResponseField>

<ResponseField name="building_condition" type="string">
  Building condition (AS_NEW, GOOD, TO_RENOVATE, etc.). Example: `AS_NEW`
</ResponseField>

<ResponseField name="facade_count" type="integer">
  Number of facades. Example: `2`
</ResponseField>

<ResponseField name="floor_count" type="integer">
  Number of floors in the building. Example: `6`
</ResponseField>

<ResponseField name="construction_year" type="integer">
  Year the building was constructed. Example: `1950`
</ResponseField>

<ResponseField name="has_lift" type="boolean">
  Whether the building has an elevator. Example: `true`
</ResponseField>

<ResponseField name="has_terrace" type="boolean">
  Whether the property has a terrace. Example: `true`
</ResponseField>

<ResponseField name="terrace_surface" type="integer">
  Terrace surface area in square meters. Example: `15`
</ResponseField>

<ResponseField name="has_garden" type="boolean">
  Whether the property has a garden. Example: `false`
</ResponseField>

<ResponseField name="garden_surface" type="integer">
  Garden surface area in square meters. Example: `100`
</ResponseField>

<ResponseField name="epc_score" type="string">
  Energy Performance Certificate score. Example: `C`
</ResponseField>

<ResponseField name="heating_type" type="string">
  Heating type (GAS, ELECTRIC, OIL, etc.). Example: `GAS`
</ResponseField>

<ResponseField name="is_furnished" type="boolean">
  Whether the property is furnished. Example: `false`
</ResponseField>

<ResponseField name="external_reference" type="string">
  External reference number from the agency. Example: `REF-12345`
</ResponseField>

<ResponseField name="subtype" type="string">
  Property subtype (e.g. STUDIO, DUPLEX, PENTHOUSE). Example: `APARTMENT`
</ResponseField>

<ResponseField name="room_count" type="integer">
  Total number of rooms. Example: `4`
</ResponseField>

<ResponseField name="sale_status" type="string">
  Sale availability status (e.g. AVAILABLE, SOLD_OUT). Example: `AVAILABLE`
</ResponseField>

<ResponseField name="price_per_sqm" type="float">
  Price per square meter. Example: `2857.14`
</ResponseField>

<ResponseField name="old_price" type="integer">
  Previous listed price, if reduced. Example: `220000`
</ResponseField>

<ResponseField name="picture_count" type="integer">
  Total number of listing photos. Example: `12`
</ResponseField>

<ResponseField name="units" type="array | null">
  Sub-unit breakdown for new-build projects. Each entry describes one apartment unit within the project. `null` for individual listings.
</ResponseField>

<ResponseField name="project_name" type="string | null">
  Name of the new-build project, if applicable. Example: `Résidence Les Érables`
</ResponseField>

<ResponseField name="project_sold_percentage" type="float | null">
  Percentage of units already sold in a new-build project. Example: `65.0`
</ResponseField>

<ResponseField name="carbon_emission" type="float | null">
  CO₂ emission rating in kg CO₂/sqm/year. Example: `18.5`
</ResponseField>

<ResponseField name="primary_energy_consumption" type="float | null">
  Primary energy consumption in kWh/sqm/year. Example: `142.0`
</ResponseField>

<ResponseField name="has_heat_pump" type="boolean">
  Whether the property has a heat pump. Example: `false`
</ResponseField>

<ResponseField name="has_photovoltaic_panels" type="boolean">
  Whether the property has solar (PV) panels. Example: `false`
</ResponseField>

<ResponseField name="has_double_glazing" type="boolean">
  Whether the property has double-glazed windows. Example: `true`
</ResponseField>

<ResponseField name="has_asbestos_certificate" type="boolean">
  Whether an asbestos certificate is present. Example: `false`
</ResponseField>

<ResponseField name="has_electrical_compliance" type="boolean">
  Whether the electrical installation has a compliance certificate. Example: `true`
</ResponseField>

<ResponseField name="has_valid_flood_certificate" type="boolean">
  Whether a valid flood-risk certificate is present. Example: `true`
</ResponseField>

<ResponseField name="oil_tank_certificate_status" type="string | null">
  Status of the oil-tank certificate, if applicable. Example: `COMPLIANT`
</ResponseField>

<ResponseField name="kitchen_type" type="string">
  Kitchen type (e.g. INSTALLED, SEMI_EQUIPPED, NOT_INSTALLED). Example: `INSTALLED`
</ResponseField>

<ResponseField name="toilet_count" type="integer">
  Number of separate toilets. Example: `1`
</ResponseField>

<ResponseField name="shower_room_count" type="integer">
  Number of shower rooms (separate from bathrooms). Example: `0`
</ResponseField>

<ResponseField name="parking_count_indoor" type="integer">
  Number of indoor parking spaces included. Example: `1`
</ResponseField>

<ResponseField name="parking_count_outdoor" type="integer">
  Number of outdoor parking spaces included. Example: `0`
</ResponseField>

<ResponseField name="monthly_costs" type="integer | null">
  Monthly co-ownership charges in the listing currency. Example: `150`
</ResponseField>

<ResponseField name="amenities" type="array">
  List of amenity strings reported on the listing. Example: `["BARBECUE", "BIKE_STORAGE"]`
</ResponseField>

<ResponseField name="has_swimming_pool" type="boolean">
  Whether the property has a swimming pool. Example: `false`
</ResponseField>

<ResponseField name="has_air_conditioning" type="boolean">
  Whether the property has air conditioning. Example: `false`
</ResponseField>

<ResponseField name="has_disabled_access" type="boolean">
  Whether the property has disabled-access provisions. Example: `false`
</ResponseField>

<ResponseField name="has_internet" type="boolean">
  Whether internet access is included. Example: `false`
</ResponseField>

<ResponseField name="has_alarm" type="boolean">
  Whether the property has an alarm system. Example: `false`
</ResponseField>

<ResponseField name="view_count" type="integer">
  Number of times the listing has been viewed on Immoweb. Example: `847`
</ResponseField>

<ResponseField name="bookmark_count" type="integer">
  Number of times the listing has been saved/bookmarked. Example: `23`
</ResponseField>

<ResponseField name="agency_website" type="string | null">
  Website URL of the agency. Example: `https://www.agencyname.be`
</ResponseField>

## Response

```json 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
}
```
