IMPORTANT POINTS TO NOTE:
Please read all the instructions below ... carefully.
These instructions are intended for your web designer.
This feeds is for your website exclusively and cannot be sent to any portals or used on any other websites.
This is an incremental feed, not a static feed.
You need to raise a chat to request any new feeds.
We can provide support on the usage of our feeds, but the implementation and loading of our feeds to your website and database is the responsibility of your web developer and/or programmer.
Is it possible to filter an XML feed? XML feeds will not be filtered, filtering will need to be done by your web developer. If you wish to have more specific search functions it is advised to use the WebAPI.
IMPORTANT UPDATE for agents already using our XML feed:
Agencies that use our XML incremental feed containing other agencies listings are obliged to keep their website(s) up-to-date. This means that website feeds should be executed nightly to ensure that any changes on the shared database during the day will be correctly reflected on the website for the next day.
Web developers, please ensure that this is being done, and let us know if you have any questions about this. Agents that do not keep their websites updated run the risk of having their XML feed stopped.
Any incremental feeds that are inactive for 60 days will automatically be shut down and will not be reactivated.
URL:
Please note that the feed is incremental and will include only properties which have been added or updated since the last run of the feed. You will need to check the value of the tag to see if a property has changed from being available to being no longer available (the status value will be one of ‘Available’, ‘Off Market’ or ‘Sold’).
The feed contains property information in English and Spanish - other system languages can be added on request.
All xml feeds are restricted from running during business hours 10:00 – 18:00 (CET) (Monday – Friday).
Feeds should ideally be set to run once a day. Repeated or constant running of feeds in a short period of time can result in the feed being suspended without notice.
New feeds will have 5 days of unrestricted access to accommodate database construction and testing.
Three parameters are available to control the addition of Energy Rating information to the feed (by default, they are all set to ‘false’):
&ER_Image=true - include the Energy Rating image as an additional image if the property has an Energy Rating
&ER_Show=true - include the Energy Rating details for each property in the feed
&ER_Only=true - only include those properties which have an Energy Rating
Other parameters are available to control feed content:
&IC=[n] - where [n] is the maximum number of pictures to be included for each property
&Language=[1,2,3,4,5,6,7,8,9,10] - comma separated list of our numeric language constants
&FA=[aaa,bbb,ccc] - comma separated list of area acronyms :
Comma separated list of Area/Province acronyms :Short codes for areas"CDS" "Costa del Sol"
"CDSE" "Costa del Sol East"
"GCT" "Granada (Costa Tropical)"
"ACA" "Almería (Costa Almería)"
"MCC" "Murcia (Costa Calida)"
"ACB" "Alicante (Costa Blanca)"
"CAZ" "Castellón (Costa del Azahar)"
"GCB" "Girona (Costa Brava)"
"TCD" "Tarragona (Costa Dorada)"
"BCD" "Barcelona (Costa Dorada)"
"IBZ" "Ibiza"
"TEN" "Tenerife"
"MAL" "Mallorca"
"MEN" "Menorca"
"COR" "Cordoba"
"CLU" "Cádiz (Costa de la Luz)"
"HLU" "Huelva (Costa de la Luz)"Short codes for Provinces"C" "A Coruña"
"VI" "Álava"
"AB " "Albacete"
"A " "Alicante"
"AL " "Almería"
"O" "Asturias"
"AV " "Ávila"
"BA" "Badajoz"
"PM " "Balears"
"B" "Barcelona"
"BI" "Bizkaia"
"BU" "Burgos"
"CC " "Cáceres"
"CA " "Cádiz"
"S" "Cantabria"
"CS" "Castellón"
"CR " "Ciudad Real"
"CO " "Córdoba"
"CU " "Cuenca"
"SS " "Gipuzkoa"
"GI " "Girona"
"GR " "Granada"
"GU " "Guadalajara"
"H " "Huelva"
"HU" "Huesca"
"J" "Jaén"
"LO " "La Rioja"
"GC " "Las Palmas"
"LE " "León"
"L " "Lleida"
"LU" "Lugo"
"M" "Madrid"
"MA " "Málaga"
"MU" "Murcia"
"NA " "Navarra"
"OR " "Ourense"
"P " "Palencia"
"PO" "Pontevedra"
"SA " "Salamanca"
"TF " "Santa Cruz de Tenerife"
"SG " "Segovia"
"SE " "Sevilla"
"SO " "Soria"
"T" "Tarragona"
"TE " "Teruel"
"TO " "Toledo"
"V" "Valencia"
"VA " "Valladolid"
"ZA " "Zamora"
"Z " "Zaragoza"
Note Short codes for Area and Province can not be mixed together.
&PA=true - include only properties from Preferred Agents
Also, three additional parameters are available:
&n=[n] - allows you to bring back a set number of property records (e.g. ‘&n=10’ will bring back the next 10 properties). It is highly recommended that you download the XML feed in steps of max. 1.000 properties to limit the transfering time of the file.
&sandbox=true - allows you to run the feed in test mode and does not update the incremental flags (n.b. only a maximum of 50 properties are returned)
&i=true - initializes the incremental flags and sends only the currently live and available properties ( this parameter can be complemented with the previous parameter "&n=[n]" )
The ‘&i=true’ parameter is a temporary parameter which is only available during the 5 day grace period for testing and construction. This can be temporarily extended upon request.
The most efficient way to process the xml feed is to:
Use PHP ‘curl’, ‘xmlreader’ or similar to run the feed url
Write the data returned down to your server as an xml file
Close the connection to our server
Read the xml data file on your server to update your database.
Please note that you need to ensure that your import program keeps its http connection open for long enough to receive the feed results. In the case of large amounts of property data, this could be up to 15 minutes. Our feed production program checks to see if the connection from the client still exists before attempting to send its output. If the connection has been broken by the client, the results cannot be sent.
When using the ‘&i=true’ parameter to load a new database or to reload an existing database:
When reloading an existing database, you will need to first remove all previous Resales-Online sourced properties from your database (if necessary, backup the data to somewhere safe beforehand)
You only need to run the feed with ‘&i=true’ for the first run of the feed (running the feed with ‘&i=true’ causes the feed program to initialise your incremental feed flags and to send only the currently live and available properties in Resales-Online)
When you use the ‘&n’ and ‘&i’ parameters to load your database, you should use them as follows :Run first feed with ‘&i=true’ and ‘&n=1000’ (or whatever number you require)Loop
Run subsequent feeds with ‘&n=1000’ (without the ‘&i’ parameter)
Until empty output received
The feed query will retrieve all those properties:
not already sent, and
updated since they were last sent.
If you return 10 properties (‘&n=10’) in a run of the feed then, when you next run the feed with ‘&n=10’, the next 10 unsent or updated properties are returned. You cannot set a start point – the feed maintains its own start point based on the above rules. The only start point you can specify is when you wish to reset the incremental flags with the ‘&i=true’ parameter.
The following articles will assist you when processing the feed:
There are only two dynamic sections in the feed:
characteristics – property features (see attached list)
images – each property can have as many pictures as the listing agency wishes to load (the maximum of any currently listed property is about 70 pictures, the average number per property is about 10)
Everything else in the feed is fixed and will appear for every property.
The new Sharing Rules will be announced soon, the following article explains how they will work - Overview of the New Property Sharing Rules
Related Articles: