XML Import Specification

Welcome to the European Real Estate XML Import Specification. This document provides all the technical details you need to create a property feed that integrates with our platform.

The European Real Estate XML feed is an absolute feed, meaning it should contain all your active properties each time it's generated.

How Properties Are Processed

Technical Requirements

• All XML tags MUST be lowercase
• The feed MUST be UTF-8 encoded
• Line breaks in descriptions must use actual newline characters (\n)
• Do NOT use CDATA sections and do not send HTML in <desc>
• URLs must be absolute (include full https:// prefix)
• Each account requires a unique feed URL
• Property nodes must be direct children of <root>

Data Format Standards

Every feed follows this basic structure: a root element with the format version, followed by one property node per active property.

<?xml version="1.0" encoding="UTF-8"?>
<root>

<european_realestate>
<feed_version>2</feed_version>
</european_realestate>

<property>
<!-- Property 1 fields... -->
</property>

<property>
<!-- Property 2 fields... -->
</property>

<!-- Additional properties... -->

</root>

What The Platform Reads From The Feed

Every element below belongs inside a single <property> node. Element names are exactly as written here.

Core Fields

<id>987654</id>

<ref>ABC-123</ref>

Pricing

<price>250000</price>

<currency>EUR</currency>

<price_freq>sale</price_freq>

Location

<country>Spain</country>

<town>Marbella</town>

<province>Málaga</province>

<postal_code>29600</postal_code>

<location_detail>Costa del Sol</location_detail>

<location>
<latitude>36.5108</latitude>
<longitude>-4.8855</longitude>
</location>

Property Details

<type>Apartment</type>

<beds>3</beds>

<baths>2</baths>

<year_built>2020</year_built>

<surface_area>
<built>150</built>
<plot>500</plot>
</surface_area>

<energy_rating>
<consumption>B</consumption>
<emissions>C</emissions>
</energy_rating>

Content

<desc>
<en>Beautiful modern apartment located in the heart of Marbella.</en>
</desc>

<url>
<en>https://example.com/property/123456</en>
</url>

Media

<images>
<image>
<url>https://example.com/images/main.jpg</url>
</image>
<image>
<url>https://example.com/images/bedroom.jpg</url>
</image>
</images>

<virtual_tour_url>https://my.matterport.com/show/?m=XXXXX</virtual_tour_url>

<video_url>https://www.youtube.com/watch?v=XXXXX</video_url>

<features>
<feature>Swimming Pool</feature>
<feature>Sea views</feature>
<feature>Air Conditioning</feature>
</features>

Use these values for the <type> field. Matching is case-insensitive.

Apartments

Villas

Town Houses

Country Houses

Land & Ruins

Commercial Property

Other

Include only the features that apply to your property, one <feature> element each. Use these names; matching is case-insensitive.

Use the country name for the <country> field, or the ISO 3166-1 alpha-2 code.

Your feed MUST be UTF-8 encoded. Special characters in text content must be properly escaped:

✅ Correct <en>Property with pool &amp; garden</en>

❌ Incorrect <en>Property with pool & garden</en>

Step 1: Validate XML Structure

Validate your feed with an XML validator before submitting it:

• W3C Markup Validation Service
• XMLValidation.com
• Most modern browsers (open the XML file directly)

Step 2: Check Character Encoding

Verify your feed is properly UTF-8 encoded:

• W3C Internationalization Checker

Step 3: Verify Required Fields

Every property needs these elements:

• <id> — Unique property ID
• <price> — Property price
• <price_freq> — Sale or rent
• <type> — Property type
• <country> — Country
• <town> — City or town
• <desc><en> — Property description

Once your feed is approved, our system syncs your properties automatically every night.

Sync Schedule

• Feeds are processed automatically every 24 hours
• Processing starts after 01:00 CET and continues through the early morning
• Large feeds may take longer to process

Best Practices

• Always include ALL active properties in your feed
• Keep the <id> of a property stable for its whole life
• Send up to 20 images per property; the first one is the cover
• Send absolute image URLs that stay reachable; images are only downloaded once
• Ensure your feed URL remains consistent and accessible
• Monitor for any validation errors reported by our team

If you have questions or encounter issues with your XML feed:

• Email: info@european.realestate
• Contact Form: european.realestate/contact

When contacting support, please include:

• Your feed URL
• Your agency name on European Real Estate
• A couple of the <id> values involved
• A description of the issue
• Any error messages received