<?xml version="1.0" encoding="UTF-8"?>

<!-- 
European Real Estate Property EXPORT Specification V1.0 - 2026-01-08
Custom XML format for european.realestate
-->

<!-- 
This document specifies the XML feed format to 
EXPORT property information TO european.realestate

For support, visit: https://european.realestate/contact/
-->

<!-- Start XML specification -->

<root>
<!-- Opens the feed -->

    <european_realestate>
        <feed_version>1</feed_version>
    </european_realestate>
    <!-- Identifies the feed version -->

    <agent>
    <!-- Start of agent node -->

        <id>123456</id>
        <!-- European Real Estate agent ID -->

        <name>Example Real Estate Agency</name>
        <!-- Agent/Agency name -->

        <email>contact@example.com</email>
        <!-- Email address -->

        <tel>+34 123 456 789</tel>
        <!-- Telephone number -->

        <mob>+34 123 456 789</mob>
        <!-- Mobile number -->

        <fax>+34 123 456 789</fax>
        <!-- Fax number (optional) -->

        <addr1>123 Main Street</addr1>
        <!-- Address line 1 -->

        <addr2>Suite 100</addr2>
        <!-- Address line 2 (optional) -->

        <town>Madrid</town>
        <!-- Address town/city -->

        <region>Madrid</region>
        <!-- Address region/province -->

        <postcode>28001</postcode>
        <!-- Address postcode -->

        <country>Spain</country>
        <!-- Address country -->

        <logo>https://www.example.com/logo.jpg</logo>
        <!-- Path to agent logo (recommended: 200x200px) -->

        <website>https://www.example.com</website>
        <!-- Agent website URL -->

    </agent>
    <!-- End of agent node -->

    <property>
    <!-- Start of property node -->

        <id>987654</id>
        <!-- Unique property ID (required) -->

        <date>2026-01-08 12:00:00</date>
        <!-- Property last modified datetime (required) -->

        <ref>ABC-123</ref>
        <!-- Agent's internal property reference -->

        <!-- === PRICING === -->

        <price>250000</price>
        <!-- Property price (numeric, no currency symbols) -->

        <currency>EUR</currency>
        <!-- Property currency
            Supported: EUR (default), GBP, USD, CHF, PLN, CZK, HUF, RON, SEK, NOK, DKK -->

        <status>for_sale</status>
        <!-- Property status (required)
            'for_sale' - Property is for sale
            'for_rent' - Property is for rent -->

        <price_period>month</price_period>
        <!-- For rentals only
            'week' - Weekly rental
            'month' - Monthly rental
            'year' - Yearly rental
            Missing tag = one-time purchase price -->

        <!-- === PROPERTY TYPE === -->

        <type>apartment</type>
        <!-- Property type (required)
            
            APARTMENTS:
            'apartment', 'duplex', 'maisonette', 'penthouse', 'studio', 'triplex'
            
            COMMERCIAL PROPERTY:
            'business', 'complex', 'farm', 'hotel', 'shop'
            
            COUNTRY HOUSES:
            'chalet', 'cortijo', 'farmhouse', 'finca'
            
            LAND & RUINS:
            'island', 'land', 'ruin'
            
            OTHER:
            'cave_house', 'chateau', 'mobile_home'
            
            PARKINGS:
            'parking'
            
            TOWN HOUSES:
            'detached', 'semi_detached', 'terraced', 'village_house'
            
            VILLAS:
            'bungalow', 'villa' -->

        <type_category>apartments</type_category>
        <!-- Property category grouping (optional)
            'apartments', 'commercial', 'country_houses', 'land_ruins', 
            'other', 'parkings', 'town_houses', 'villas' -->

        <!-- === CONDITION === -->

        <condition>good_condition</condition>
        <!-- Property condition
            'newly_built' - Less than 5 years old
            'good_condition' - Well maintained
            'needs_renovating' - Requires renovation
            'under_construction' - Currently being built
            'buildable_land' - Land ready for construction
            Missing tag = condition unknown -->

        <!-- === LOCATION === -->

        <country_code>ES</country_code>
        <!-- ISO 3166-1 alpha-2 country code (required)
            Supported EU countries:
            AL (Albania), AT (Austria), BE (Belgium), BA (Bosnia & Herzegovina),
            BG (Bulgaria), HR (Croatia), CY (Cyprus), CZ (Czechia),
            DK (Denmark), EE (Estonia), FI (Finland), FR (France),
            GE (Georgia), DE (Germany), GR (Greece), HU (Hungary),
            IS (Iceland), IE (Ireland), IT (Italy), LV (Latvia),
            LT (Lithuania), LU (Luxembourg), MT (Malta), MD (Moldova),
            ME (Montenegro), NO (Norway), PL (Poland), PT (Portugal),
            RO (Romania), RS (Serbia), SK (Slovakia), SI (Slovenia),
            ES (Spain), SE (Sweden), CH (Switzerland), NL (Netherlands),
            GB (United Kingdom) -->

        <town>Marbella</town>
        <!-- City/Town name (required) -->

        <region>Málaga</region>
        <!-- Region/Province/State -->

        <postcode>29600</postcode>
        <!-- Postal/ZIP code -->

        <location_detail>Costa del Sol</location_detail>
        <!-- Additional location description (e.g., urbanization, neighborhood) -->

        <location>
            <latitude>36.5108</latitude>
            <longitude>-4.8855</longitude>
        </location>
        <!-- GPS coordinates
            Missing tags = location unknown -->

        <!-- === PROPERTY DETAILS === -->

        <bedrooms>3</bedrooms>
        <!-- Number of bedrooms (1-10+)
            Missing tag = no bedrooms / not applicable -->

        <bathrooms>2</bathrooms>
        <!-- Number of bathrooms (1-10+)
            Missing tag = no bathrooms / not applicable -->

        <rooms>6</rooms>
        <!-- Total number of rooms (1-10+)
            Missing tag = not specified -->

        <garage>1</garage>
        <!-- Number of garage spaces (1-10+)
            Missing tag = no garage -->

        <year_built>2020</year_built>
        <!-- Year property was built (4-digit year)
            Missing tag = year unknown -->

        <!-- === SURFACE AREA === -->

        <surface_area>
            <built>150</built>
            <!-- Built/Living area in square metres -->
            <plot>500</plot>
            <!-- Plot/Land area in square metres -->
        </surface_area>
        <!-- Area measurements
            Missing tags = area unknown -->

        <!-- === ENERGY RATING === -->

        <energy_rating>
            <consumption>B</consumption>
            <!-- Energy consumption rating: A, B, C, D, E, F, G -->
            <emissions>C</emissions>
            <!-- CO2 emissions rating: A, B, C, D, E, F, G -->
        </energy_rating>
        <!-- Energy performance certificate ratings
            Missing tags = not certified / unknown -->

        <!-- === FEATURES === -->

        <features>
        <!-- Property features - include only those that apply -->

            <!-- ACCESSIBILITY -->
            <feature>accessible</feature>
            <!-- Property is accessible for people with disabilities -->

            <!-- CLIMATE CONTROL -->
            <feature>air_conditioning</feature>
            <!-- Air conditioning installed -->

            <!-- OUTDOOR -->
            <feature>barbeque</feature>
            <!-- BBQ area available -->

            <feature>garden</feature>
            <!-- Garden area -->

            <feature>lawn</feature>
            <!-- Lawn area -->

            <feature>outdoor_shower</feature>
            <!-- Outdoor shower -->

            <feature>swimming_pool</feature>
            <!-- Swimming pool (private or communal) -->

            <feature>terrace</feature>
            <!-- Terrace or balcony -->

            <!-- STORAGE -->
            <feature>basement</feature>
            <!-- Basement area -->

            <feature>storage_room</feature>
            <!-- Storage room -->

            <feature>fitted_wardrobes</feature>
            <!-- Built-in wardrobes -->

            <!-- BUILDING AMENITIES -->
            <feature>elevator</feature>
            <!-- Elevator access -->

            <feature>gym</feature>
            <!-- Gym/Fitness center -->

            <feature>sauna</feature>
            <!-- Sauna -->

            <feature>laundry</feature>
            <!-- Laundry room/facilities -->

            <!-- PARKING -->
            <feature>garage</feature>
            <!-- Garage (use <garage> count for number) -->

            <feature>parking</feature>
            <!-- Parking space available -->

            <!-- UTILITIES & CONNECTIVITY -->
            <feature>internet</feature>
            <!-- Internet connection available -->

            <feature>wifi</feature>
            <!-- WiFi included/available -->

            <feature>phone_line</feature>
            <!-- Telephone line installed -->

            <feature>tv_cable</feature>
            <!-- Cable TV connection -->

            <!-- INTERIOR -->
            <feature>furnished</feature>
            <!-- Property is furnished -->

            <feature>window_coverings</feature>
            <!-- Window blinds/curtains included -->

            <!-- VIEWS -->
            <feature>sea_views</feature>
            <!-- Sea/Ocean views -->

            <!-- SUSTAINABILITY -->
            <feature>off_grid</feature>
            <!-- Off-grid/Self-sufficient property -->

        </features>
        <!-- 
        Complete list of supported features:
        accessible, air_conditioning, barbeque, basement, elevator,
        fitted_wardrobes, furnished, garage, garden, gym, internet,
        laundry, lawn, off_grid, outdoor_shower, parking, phone_line,
        sauna, sea_views, storage_room, swimming_pool, terrace,
        tv_cable, wifi, window_coverings
        -->

        <!-- === URL === -->

        <url>https://example.com/property/123456</url>
        <!-- URL to property page on agent website
            Missing tag = no URL available -->

        <!-- === TITLE & DESCRIPTION === -->

        <title>Stunning 3-Bedroom Apartment with Sea Views</title>
        <!-- Property title in English (max 100 characters)
            Translations are generated automatically after import -->

        <desc>Beautiful modern apartment located in the heart of Marbella. This stunning property features 3 spacious bedrooms, 2 modern bathrooms, and a large terrace with breathtaking sea views. The open-plan living area is flooded with natural light and opens onto the terrace. The property includes air conditioning, fitted wardrobes, and a private parking space.</desc>
        <!-- Property description in English
            Translations are generated automatically after import -->

        <notes>Agent notes or additional property information</notes>
        <!-- Private notes (max 500 characters)
            These may be visible to agents only -->

        <!-- === IMAGES === -->

        <images>
        <!-- Start of images node
            Images sorted by display priority (first = primary)
            Maximum 50 images per property
            Recommended size: 1920x1280px (3:2 ratio)
            Minimum size: 800x600px
            Supported formats: JPG, PNG, WebP -->

            <image id="1">
                <url>https://example.com/images/property/123/main.jpg</url>
                <title>Living Room</title>
                <!-- Optional image title/caption -->
            </image>

            <image id="2">
                <url>https://example.com/images/property/123/bedroom1.jpg</url>
                <title>Master Bedroom</title>
            </image>

            <image id="3">
                <url>https://example.com/images/property/123/kitchen.jpg</url>
                <title>Modern Kitchen</title>
            </image>

            <image id="4">
                <url>https://example.com/images/property/123/terrace.jpg</url>
                <title>Sea View Terrace</title>
            </image>

        </images>
        <!-- End of images node -->

        <!-- === VIRTUAL TOUR === -->

        <virtual_tour>https://example.com/tour/123456</virtual_tour>
        <!-- URL to virtual tour (Matterport, iGuide, etc.)
            Missing tag = no virtual tour available -->

        <!-- === VIDEO === -->

        <video>
            <url>https://youtube.com/watch?v=XXXXX</url>
            <type>youtube</type>
            <!-- Video type: 'youtube', 'vimeo', 'direct'
                'direct' for MP4/WebM hosted files -->
        </video>
        <!-- Property video
            Missing tag = no video available -->

    </property>
    <!-- End of property node -->

    <!-- Additional properties follow the same structure -->

</root>
<!-- Closes the document -->

<!-- End XML specification -->

<!--
================================================================================
EUROPEAN REAL ESTATE XML V1 - QUICK REFERENCE
================================================================================

REQUIRED FIELDS:
- property/id           Unique property identifier
- property/date         Last modified datetime
- property/price        Numeric price value
- property/status       Sale/rent status
- property/type         Property type
- property/country_code ISO country code
- property/town         City/Town name
- desc                  English description

RECOMMENDED FIELDS:
- property/bedrooms     Number of bedrooms
- property/bathrooms    Number of bathrooms
- surface_area/built    Living area in m²
- images                At least 5 photos
- title                 English title

STATUS VALUES:
for_sale, for_rent

PROPERTY TYPES:
Apartments: apartment, duplex, maisonette, penthouse, studio, triplex
Commercial: business, complex, farm, hotel, shop
Country: chalet, cortijo, farmhouse, finca
Land: island, land, ruin
Other: cave_house, chateau, mobile_home, parking
Town Houses: detached, semi_detached, terraced, village_house
Villas: bungalow, villa

CONDITION VALUES:
newly_built, good_condition, needs_renovating, under_construction, buildable_land

COUNTRY CODES (37 supported):
AL, AT, BA, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GE, GR, HR, HU, 
IE, IS, IT, LT, LU, LV, MD, ME, MT, NL, NO, PL, PT, RO, RS, SE, SI, SK

FEATURES (25 total):
accessible, air_conditioning, barbeque, basement, elevator, fitted_wardrobes,
furnished, garage, garden, gym, internet, laundry, lawn, off_grid, 
outdoor_shower, parking, phone_line, sauna, sea_views, storage_room, 
swimming_pool, terrace, tv_cable, wifi, window_coverings

================================================================================
-->
