Nuroa Real Estate XML Feed – About nuroa.co.uk

If you have a real estate portal or a classified web site and you want to include your listing in Nuroa, you only have to follow these simple steps:

Contact us to know which is the best solution for your needs.
Create an UFT-8 XML file in the format specified below.
Make sure there are no syntax errors in the file that prevents the proper XML processing. To do that you can use any XML validator available on the internet, like https://codebeautify.org/xmlvalidate.
Provide us the URL where the XML file is stored.If you prefer we offer you the possibility to upload your file into our FTP server. Contact us and we will send you the login.

Once we have received your XML, we will index your listing in Nuroa.

Useful information

Below you will find all the specifications and fields required for the indexation of your ads in Nuroa. It is very important that the XML feed includes all the required fields. If you need more information about XML format check wikipedia.

Feed processing information:

When a feed is processed and an ad is already indexed in Nuroa, only the following field of the ad will be updated : <ad_type>, <category> and <price>. An ad will be fully updated (all the property fields) when the date of the field <last_update> is modified.
The picture shown on Nuroa is the first of the set of pictures in the XML. We don’t allow corporate images with information such as “No image available”.
In case the XML feed does not meet all the requirements mentioned in this page Nuroa can, under no circumstances, be considered responsible for the poor processing of the information provided. Nuroa also disclaims any responsibility for the accuracy or inaccuracy of the data provided. The updating of the information contained in the XML file will be under the responsibility of the advertiser.

XML Structure

The general structure of the document is shown in the box below. Required fields are in bold. When a field is required, it must contain information, if not the ad will not be integrated into our data base. If no data to fill in an optional field are available, you have to leave the field empty.

Regarding the ads, it is imperative to have a single URL for each one of them, or in other words it cannot be two ads associated to the same URL.

<?XML version=“1.0” encoding=“UTF-8”?>
<nuroa>

    <property>
    <id><![CDATA[ . . . ]]></id>
    <link><![CDATA[ . . . ]]></link>
    <overseas><![CDATA[ . . . ]]></overseas> 

    <pictures>
        <picture>
            <picture_url><![CDATA[ . . . ]]></picture_url>
            <picture_title><![CDATA[ . . . ]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[ . . . ]]></picture_url>
            <picture_title><![CDATA[ . . . ]]></picture_title>
        </picture> 

    ...

    </pictures> 

    <agency_name><![CDATA[ . . . ]]></agency_name>
    <agency_address><![CDATA[ . . . ]]></agency_address> 

    <ad_type><![CDATA[ . . . ]]></ad_type>
    <category><![CDATA[ . . . ]]></category> 

    <title><![CDATA[ . . . ]]></title>
    <description><![CDATA[ . . . ]]></description>
    <european_energy_class><![CDATA[ . . . ]]></european_energy_class>
    <european_energy_index><![CDATA[ . . . ]]></european_energy_index>
    <rooms><![CDATA[ . . . ]]></rooms>
    <bathrooms><![CDATA[ . . . ]]></bathrooms>
    <square_meters><![CDATA[ . . . ]]></square_meters>
    <floor_number><![CDATA[ . . . ]]></floor_number>
    <condition><![CDATA[ . . . ]]></condition>

    <owner><![CDATA[ . . . ]]></owner>
    <bank><![CDATA[ . . . ]]></bank>

    <price><![CDATA[ . . . ]]></price>
    <price_day><![CDATA[ . . . ]]></price_day>
    <price_week><![CDATA[ . . . ]]></price_week>
    <currency><![CDATA[ . . . ]]></currency>

    <city><![CDATA[ . . . ]]></city>
    <country><![CDATA[ . . . ]]></country>
    <location><![CDATA[ . . . ]]></location>
    <postcode><![CDATA[ . . . ]]></postcode>
    <neighbourhood><![CDATA[ . . . ]]></neighbourhood>
    <longitude><![CDATA [ . . . ]]></longitude>
    <latitude><![CDATA[ . . . ]]></latitude>

    <insertion_date><![CDATA[ . . . ]]></insertion_date>
    </property>
...

</nuroa>

Required fields

id: id of the ad on your website (numeric or alphanumeric but it must be unique) – Free text string

link: Ads URL. It must be a single URL for each ad or, in other words, it is not allowed to have two or more ads associated to the same URL

overseas: This field it is only required for overseas feeds and it must contain the numeric value 1 (ex. <overseas><![CDATA[1]]></overseas>)

ad_type: Type of the ad – Fixed text string: sale | new development | rent | flatshare

category: The property type of the ad (ex. house, flat, studio, detached_house, office, parking, etc.) – Free text string

title: Ads title (ex. Newly refurbished flat in London – Brick Lane!) – Free text string

description: Ads description – Free text string

price: Price in Pound Streling of the property, to use for properties for sale and rent. In the case of a property to rent it is mandatory to use this field only if the price is monthly based. For price per day or price per week rentals use the appropriate field below – Numerical decimal

price_day: Price of the property in Pound per day, only for property to rent – Numerical decimal

price_week: Price of the property in Pound per week, only for property to rent – Numerical decimal

city: The name of the city where the property is located – Free text string

country: The name of the country where the property is located (ex. United Kingdom) – Free text string

insertion_date: Date of the ad insertion – Date format: dd/mm/YYYY (ex. 01/01/2011)

longitude: Longitud. This is an important field for the organic ranking in Nuroa however feeds will be accepted without this field – Numerical decimal

latitude: Latitud. This is an important field for the organic ranking in Nuroa however feeds will be accepted without this field – Numerical decimal

Recommended fields for a better conversion and ranking in Nuroa results

picture_url: URL where the picture of the property is located

agency_name: Estate agent name – Free text string

agency_address: Estate agent address – Free text string

rooms: Number of rooms – Numerical integer

bathrooms: Number of bathrooms – Numerical integer

square_meters: Area of the property – Numerical integer

floor_number: floor number – Numerical integer

location: Addres where the property is located – Free text string

postcode: The postcode of the area where the property is located – Free text string

neighbourhood: Neighbourhood or district (ex. tower hamlets) – Free text string

Optional fields

picture_title: Title of the picture (ex. living room) – Free text string

condition: The conditions of the property (ex. newly refurbished) – Free text string

owner: If the property is managed by the owner. Format: 1 = the property is for sale/rent by owner. It’s not necessary to include this field if the property is being marketed by an Estate Agent – Numerical boolean

bank: If the property is managed by a bank. Format: 1 = the property is for sale/rent by bank. It’s not necessary to include this field if the property is being marketed by an Estate Agent – Numerical boolean