- Book a call
- Contact us
- System
- Samples
- Properties
- Reporting
- Properties Alerts
- DVF
- Samples
- Reporting
- Adverts
- Adverts Alerts
System
Properties
DVF
Adverts
Retrieve a property by url
Retrieve a property by one of it’s advert URL
Url of an advert to get the associated property
Authorizations
Query Parameters
Url of an advert to get the associated property
Response
List of adverts linked to this property - adverts can be from different sources, different prices, different agencies, etc.
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Longitude and latitude as an array of number, first longitude then latitude [lng, lat]
CURRENCY_EUR, CURRENCY_USD The initial price of the property - price of the first advert we found for this property
The latest price of the property - price of the last advert we found for this property
PRICING_ONE_OFF, PRICING_MENSUAL The variation of the price between two states of the advert
The value of the price variation in %
The value of the price variation in %
The absolute value of the price variation in %
The absolute value of the price variation in %
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
An anomaly or incoherence have been detected
SELLER_TYPE_UNKNOWN, SELLER_TYPE_AGENCY, SELLER_TYPE_NETWORK By default, will be the description of the first advert
Unique identifier of the property
Habitation characteristics of the property
The energetic classes of the property (DPE/GES)
The classification value of the greenhouse gas emission classification - GES
GREENHOUSE_CLASSIFICATION_UNKNOWN, GREENHOUSE_CLASSIFICATION_G, GREENHOUSE_CLASSIFICATION_F, GREENHOUSE_CLASSIFICATION_E, GREENHOUSE_CLASSIFICATION_D, GREENHOUSE_CLASSIFICATION_C, GREENHOUSE_CLASSIFICATION_B, GREENHOUSE_CLASSIFICATION_A, GREENHOUSE_CLASSIFICATION_NC The value of the greenhouse gas emission classification - GES in kgCO2/m²/year
The classification value of the energy classification - DPE
ENERGY_CLASSIFICATION_UNKNOWN, ENERGY_CLASSIFICATION_G, ENERGY_CLASSIFICATION_F, ENERGY_CLASSIFICATION_E, ENERGY_CLASSIFICATION_D, ENERGY_CLASSIFICATION_C, ENERGY_CLASSIFICATION_B, ENERGY_CLASSIFICATION_A, ENERGY_CLASSIFICATION_NC The value of the energy classification - DPE in kWhEP/m²/year
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
EXPOSURE_UNKNOWN, EXPOSURE_NORTH, EXPOSURE_NORTH_EAST, EXPOSURE_EAST, EXPOSURE_SOUTH_EAST, EXPOSURE_SOUTH, EXPOSURE_SOUTH_WEST, EXPOSURE_WEST, EXPOSURE_NORTH_WEST UNKNOWN_FURNITURE, UNFURNISHED, PARTIALLY_FURNISHED, FULLY_FURNISHED VIEW_TYPE_UNKNOWN, VIEW_TYPE_GLIMPSE, VIEW_TYPE_PANORAMIC, VIEW_TYPE_CLEAR, VIEW_TYPE_EXCEPTIONAL, VIEW_TYPE_DOMINANT MATERIAL_UNKNOWN, MATERIAL_WOODEN, MATERIAL_STEEL, MATERIAL_STONE, MATERIAL_PVC, MATERIAL_CONCRETE, MATERIAL_ALUMINIUM, MATERIAL_HALF_TIMBERED, MATERIAL_MARBLE, MATERIAL_BRICK, MATERIAL_CINDER_BLOCK, MATERIAL_PREFABRICATED, MATERIAL_ADOBE, MATERIAL_COATING VIEW_ON_UNKNOWN, VIEW_ON_SEA, VIEW_ON_HILLS, VIEW_ON_RIVERS, VIEW_ON_CITY, VIEW_ON_PARK, VIEW_ON_VERDURE, VIEW_ON_STREET, VIEW_ON_COURTYARD, VIEW_ON_COUNTRYSIDE, VIEW_ON_MOUNTAIN, VIEW_ON_GARDEN_TERRACE, VIEW_ON_LAKE, VIEW_ON_SKI_SLOPES, VIEW_ON_PORT, VIEW_ON_POI, VIEW_ON_SKY, VIEW_ON_WATER, VIEW_ON_VINEYARD, VIEW_ON_ROOF HEAT_TYPE_UNKNOWN, HEAT_TYPE_INDIVIDUAL, HEAT_TYPE_SHARED, HEAT_TYPE_MIX, HEAT_TYPE_CITY, HEAT_TYPE_CISTERN HEAT_DETAIL_UNKNOWN, HEAT_DETAIL_FLOOR, HEAT_DETAIL_CEILING, HEAT_DETAIL_FIREPLACE, HEAT_DETAIL_INSERT, HEAT_DETAIL_AIR_CON, HEAT_DETAIL_REVERSIBLE_AIR_CON, HEAT_DETAIL_RADIANTS_TUBES, HEAT_DETAIL_RADIATOR, HEAT_DETAIL_SHEAHS, HEAT_DETAIL_CONVECTOR HEATING_UNKNOWN, HEATING_FUEL_OIL, HEATING_ELECTRICAL, HEATING_GAS, HEATING_BIOMASS, HEATING_SOLAR, HEATING_GEOTHERMAL, HEATING_WOOD, HEATING_HEAT_PUMP, HEATING_PELLET, HEATING_CANADIAN_WELL, HEATING_COAL INTERIOR_CONDITION_UNKNOWN, INTERIOR_CONDITION_EXCELLENT, INTERIOR_CONDITION_TO_REFRESH, INTERIOR_CONDITION_SMALL_WORKS_TO_BE_PLANNED, INTERIOR_CONDITION_MAJOR_WORKS_TO_BE_PALLNED, INTERIOR_CONDITION_BRAND_NEW, INTERIOR_CONDITION_GOOD_CONDITION, INTERIOR_CONDITION_TO_BE_RENOVATED GENERAL_CONDITION_UNKNOWN, GENERAL_CONDITION_TO_BE_RENOVATED, GENERAL_CONDITION_BRAND_NEW, GENERAL_CONDITION_RENOVATED, GENERAL_CONDITION_TO_BE_REFRESHED, GENERAL_CONDITION_GOOD, GENERAL_CONDITION_EXCELLENT, GENERAL_CONDITION_DECREPIT, GENERAL_CONDITION_TO_BE_BUILT The surface of the balconies in m² - we rarely have this information
The surface of the total floors in m² - we rarely have this information
The surface of the gardens in m² - we rarely have this information
The surface of the ground floor in m² - we rarely have this information
The surface of the kitchen in m² - we rarely have this information
The surface of the living space in m² - we rarely have this information
The surface of the living room in m² - we rarely have this information
The surface of the terraces in m² - we rarely have this information
The total habitable surface of the property in m²
PROPERTY_TYPE_UNKNOWN, PROPERTY_TYPE_STUDIO, PROPERTY_TYPE_T1, PROPERTY_TYPE_T1_T2, PROPERTY_TYPE_T2, PROPERTY_TYPE_T2_T3, PROPERTY_TYPE_T3, PROPERTY_TYPE_T3_4, PROPERTY_TYPE_T4, PROPERTY_TYPE_T4_5, PROPERTY_TYPE_T5_MORE, PROPERTY_TYPE_LOFT, PROPERTY_TYPE_DUPLEX, PROPERTY_TYPE_OTHER_APARTMENT_TYPE, PROPERTY_TYPE_INDIVIDUAL, PROPERTY_TYPE_ONE_SIDE_TERRACED, PROPERTY_TYPE_TWO_SIDE_TERRACED, PROPERTY_TYPE_SINGLE_STOREY, PROPERTY_TYPE_TRADITIONAL, PROPERTY_TYPE_CONTEMPORARY, PROPERTY_TYPE_BOURGEOIS, PROPERTY_TYPE_VILLA, PROPERTY_TYPE_MANOR, PROPERTY_TYPE_CASTLE, PROPERTY_TYPE_FARM, PROPERTY_TYPE_MAS, PROPERTY_TYPE_BASTIDE, PROPERTY_TYPE_CHALET, PROPERTY_TYPE_ANCIENT, PROPERTY_TYPE_HERITAGE_LISTED, PROPERTY_TYPE_BUNGALOW An anomaly or incoherence have been detected
Is the property marked as urgent
Land details of the property
LAND_UNKNOWN, LAND_BUILDING_PLOT, LAND_AGRICULTURAL, LAND_VINEYARD, LAND_INDUSTRIAL, LAND_POND, LAND_FOREST Location details of the property
The coordinates of the city center
Longitude and latitude as an array of number, first longitude then latitude [lng, lat]
Coordinates of the property - could not be accurate or precise enough
Longitude and latitude as an array of number, first longitude then latitude [lng, lat]
All the medias of the different adverts of the property
Meta data of the property
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
All the adverts of this property are offline - Meaning the property is not available anymore (sold, rented, etc.)
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Parking details of the property
PARKING_UNKNOWN, PARKING_GARAGE, PARKING_PARKING Price details of the property
CURRENCY_EUR, CURRENCY_USD The initial price of the property - price of the first advert we found for this property
The latest price of the property - price of the last advert we found for this property
PRICING_ONE_OFF, PRICING_MENSUAL The variation of the price between two states of the advert
The value of the price variation in %
The value of the price variation in %
The absolute value of the price variation in %
The absolute value of the price variation in %
List of unstructured tags of the property
By default, will be the title of the first advert
Type of the property
CLASS_UNKNOWN, CLASS_HOUSE, CLASS_FLAT, CLASS_PROGRAM, CLASS_SHOP, CLASS_PREMISES, CLASS_OFFICE, CLASS_LAND, CLASS_BUILDING, CLASS_PARKING Offer information of the property
The property is sold with someone living in it
Renting contract details
The offer is for a colocation
The offer is for long term renting (more than 6 months)
The offer is for short term renting (less than 6 months)
The offer is for a sublease
OFFER_UNKNOWN, OFFER_BUY, OFFER_RENT, OFFER_BUSINESS_TAKE_OVER, OFFER_LEASE_BACK, OFFER_LIFE_ANNUITY_SALE, OFFER_HOLIDAYS Was this page helpful?