Using Idealista properties integration feed

Please note: We recommend using the CostaNova feed structure as it offers the most comprehensive format for submitting your properties to us and ensures optimal listing quality and accuracy.

Supported Idealista feed versions: v6.00

To use the Idealista feed, take into account the following notes:

Customer object:

Required fields are:

  • customerCode
  • customerProperties

Properties object:

Required fields are:

  • propertyCode
  • propertyFeatures
  • propertyOperation
  • propertyAddress

PropertyCode field is mapped to the Id of the property. PropertyReference field is mapped to the Reference.

Address object:

Required fields are any combination of the following:

  • "addressStreetName", "addressPostalCode", "addressCountry"
  • "addressStreetName", "addressTown", "addressCountry"
  • "addressCoordinatesLatitude", "addressCoordinatesLongitude"

Address visibility

Per property you can set the level of address visibility (addressVisibility field) to: full, street, hidden. Full means the full address will be disclosed. Street means only street name (without housenumber) is shown. Hidden means the postal zone will be displayed with the property.

Per account you can also set a default visibility, if no addressVisibility is sent we will display with default account visibility setting.

Address coordinates precision

Per property you can set the level of address coordinates precision (addressCoordinatesPrecision field) to: exact, moved. Exact means the exact coordinate location will be shown. Moved means the map will be displayed on the postal zone of the property.

Per account you can also set a default map precision, if no addressVisibility is sent we will display with default account map precision setting.

Coordinates: to have a good accuracy, latitude and longitude need to have at least 4 decimals.

Property Operation

At the moment only the properties with operation type sale will be imported.

Property Visibility

At the moment only the properties with visibility idealista will be imported.