Each feed URL can only contain property information for a single CostaNova account or estate agent. If you are creating feeds for multiple estate agents, each one will need have its own feed.
We support multiple feed formats.
However 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.
We support the following import formats:
If you do not use the CostaNova feed structure, please read the instructions on the specific feeds for extra information about the custom feeds.
All files should be in UTF-8 encoding.
We provide an online validator to test out the structure of your feed: https://validator.costanova.es
The feed will be downloaded and processed at most once every hour. The exact schedule can vary, our system will automatically decide on the best suitable schedule for you.
The feed can be downloaded from a public URL like: https://www.website.com/feed.json or from an FTP location. The location of the feed can be set in the management portal.
You can download an example of a valid feed JSON here:
The feed should be a JSON file conforming to the following JSON Schema specification files:
The feed JSON contains 3 objects:
feed which describes the current version this feed uses.account object contains the account Id for the estate agent.properties object which contains an array of all available properties for this estate agent.Properties which are imported using the import feed will not be able to be changed using the management portal. All changes need to be done using the property management system which generates the feed to import. You can however create new properties in the management portal which are managed side-by-side with the imported properties.
In order to correctly insert, update or delete, we must consistently identify each property as a unique entity in your feed. We do this using the Id field which must consistently and uniquely identify each one of your properties. There also is a Reference field, this is a (human-readable) reference you can use to identify this property in your own systems. We will show this reference publicly on our site.
Your property feed must always contain ALL of your properties - not only changed or updated. Each time we process a feed, we evaluate it against every property for that account in the CostaNova database. Your feed must contain ALL the properties that you want ADDED or UPDATED. It should not contain any properties that you want to DELETE.
When a property is ADDED to your database, there will be a new property record for it in your feed. It will be INSERTED to our database and we will process and store all associated images on our platform.
If a property is UPDATED in your database, the property date field in your feed should also change. When we see a change in the date field, the property will be UPDATED in our database and we will process all images. Please note, if the date does not change, we will not update the property.
A property will be DELETED from our platform when there is no property record for it in your feed. We DELETE properties and any associated images from our database when there is no matching property record in your feed. The exception to this are properties which are added manually using the management portal.
All dates in your property feed should follow the format 'yyyy-MM-dd HH:mm:ss' and align with the local Madrid timezone: "(UTC+01:00) Brussels, Copenhagen, Madrid, Paris".
Our address format consists of the following fields:
| Field | Value | Type | Description |
|---|---|---|---|
| Street | "Carrer del Passarell" | Alphanumeric | Street name, without house number or additions |
| HouseNumber | "2" | Alphanumeric | House number with optional additions |
| Zone | "Urbanization Costa Nova" | Alphanumeric | |
| PostalCode | "03738" | Alphanumeric | Postal code, 5 numbers |
| Town | "Madrid" | Alphanumeric | |
| Country | "Spain" | Alphanumeric | |
| Visibility | "exact" "street" or "hidden" | Alphanumeric | This defines the visibility of this address on the property. If null, it will use the default address visibility set at account level. |
| MapPrecision | "exact" "street" or "hidden" | Alphanumeric | This defines the precision of this property on the map. If null, it will use the default map precision set at account level. |
| Latitude | 40.416775 | Number | The latitude coordinate of the exact location of the property. |
| Longitude | -3.703790 | Number | The longitude coordinate of the exact location of the property. |
An address input is required, at least one of the following field combinations are required:
When importing a property, the following steps are taken:
Per property you can set the level of address visibility to: exact, street, hidden. Exact 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.
Per property you can set the level of precision that will be shown on the map: exact, street, hidden. Exact means the exact coordinate location will be shown. Street means a random location will be shown on that street. Hidden 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.
If coordinates are sent, we will not publish the exact visibility on the map by default, maximum with street only visibility
Coordinates: to have a good accuracy, latitude and longitude need to have at least 4 decimals.