Generate
Export every active property in one XML file. Although optional, an <agency> block containing the agency name is strongly recommended.
The complete technical specification for connecting your property software to our international seaside real-estate portal.
<properties>
<agency>
<name>Agency name</name>
<email>[email protected]</email>
</agency>
<property>
<reference>A321z</reference>
<last_update>2026-10-23</last_update>
<type_transaction>sale</type_transaction>
<type>Villa</type>
<city>Nice</city>
<country>France</country>
<price>2600000</price>
<text_en>Property description…</text_en>
<photos>…</photos>
<plans>…</plans>
</property>
</properties>Provide one complete XML document at a stable HTTPS address. Our importer checks it every night and publishes eligible properties.
Export every active property in one XML file. Although optional, an <agency> block containing the agency name is strongly recommended.
Expose the complete file through a stable HTTPS URL.
Share the feed URL with Mer et Demeures so we can configure and test the import.
Send every active property on every update. Listings absent from the feed can no longer be maintained on the portal.
Each property must keep one stable, unique reference. If a duplicate occurs, only the first property is processed.
Use last_update in YYYY-MM-DD format and change it whenever the property content changes.
Supply a substantial text in English, French, Italian, Spanish or Portuguese. Missing destination languages are translated automatically.
Provide at least one directly accessible image URL. A property can contain up to 30 photos.
Set sea_view and waterfront explicitly when applicable. “Beach walk” can be inferred from the beach distance or description keywords.
Tags marked Required must contain a value. Recommended tags improve feed identification, listing completeness and search filtering. Optional tags may be omitted when unavailable.
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<properties>Required | XML element | Root element containing all properties and, optionally, agency information. | — |
<agency>Recommended | XML element | Optional container that makes the feed easier to identify. | — |
<name>Recommended | Text | Agency name used to identify the feed during setup and support. | Riviera Estates |
<email>Optional | Agency contact email. | [email protected] | |
<phone>Optional | Text / phone | Agency phone number. | +33 4 94 00 00 00 |
<nationality>Optional | Text | Agency country. | France |
<address>Optional | Text | Agency street address. | 24 avenue de la Mer |
<zipcode>Optional | Alphanumeric | Agency postal code. | 06000 |
<city>Optional | Text | Agency city. | Nice |
<website>Optional | Absolute URL | Agency website. | https://www.riviera-estates.com |
<logo>Optional | Absolute URL | Direct URL of the agency logo. | https://www.riviera-estates.com/logo.png |
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<property>Required | XML element | Container repeated once for every active property. | — |
<reference>Required | Text / alphanumeric | Any stable, unique identifier from your system; no prefix or prescribed format. | A321z |
<last_update>Required | YYYY-MM-DD | Date when the property content last changed. | 2026-10-23 |
<contact_phone>Optional | Text / phone | Phone number used for enquiries; the account phone is used by default. | +33 4 94 00 00 00 |
<type_transaction>Required | sale | seasonal rentals | vacation rentals | Real-estate transaction.Transactions remain limited to sale and seasonal or vacation rentals; this feed does not create listings with a new-build transaction. | sale |
<type>Required | Apartment, Villa, Property, House, Plot of land, Island, Castle, Business, Building, New construction | Property category. | Villa |
<latitude>Optional | Decimal | Property latitude. | 43.7102 |
<longitude>Optional | Decimal | Property longitude. | 7.2620 |
<zip_code>Optional | Alphanumeric | Property postal code. | 06000 |
<city>Required | Text | Property city. | Nice |
<area>Optional | Text | Administrative division above the city: region, county or department. | Provence-Alpes-Côte d’Azur |
<country>Required | Text | Property country. | France |
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<price>Required | Decimal | Property price. | 2600000.00 |
<currency>Optional | EUR, USD, GBP, RUB, CHF… | ISO currency code; EUR is used when omitted. | EUR |
<price_visible>Optional | Yes | No | Whether the price is visible; Yes by default. | Yes |
<area_useful>Recommended | Decimal | Living area in square metres, whenever applicable. | 240.50 |
<area_plot>Optional | Decimal | Plot area in square metres. | 1800 |
<year>Optional | Integer (YYYY) | Construction year. | 2021 |
<floors>Optional | Integer | Floor on which the property or apartment is located. | 3 |
<rooms>Optional | Integer | Number of rooms. | 8 |
<bedrooms>Recommended | Integer | Number of bedrooms for residential properties. | 5 |
<bathroom>Recommended | Integer | Number of bathrooms for residential properties. | 3 |
<shower_room>Optional | Integer | Number of shower rooms. | 1 |
<garages>Optional | Integer | Number of garages. | 2 |
<terraces>Optional | Integer | Number of terraces. | 2 |
<balconies>Optional | Integer | Number of balconies. | 2 |
<orientation>Optional | N, NE, E, SE, S, SW, W, NW · comma-separated | One or more cardinal orientations of the property. | S, SW |
<kitchen>Optional | Integer | Number of kitchens. | 1 |
<kitchen_fitted>Optional | Integer | Number of fitted kitchens. | 1 |
<kitchen_US>Optional | Integer | Number of open-plan kitchens. | 0 |
<kitchen_independent>Optional | Integer | Number of independent kitchens. | 1 |
<garden>Optional | Yes | No | Presence of a garden. | Yes |
<air_conditioning>Optional | Yes | No | Presence of air conditioning. | Yes |
<lift>Optional | Yes | No | Presence of a lift. | Yes |
<parking>Optional | Integer | Number of parking spaces. | 2 |
<swimming_pool>Optional | Yes | No | Presence of a swimming pool. | Yes |
<cellar>Optional | Yes | No | Presence of a cellar. | Yes |
<wifi>Optional | Yes | No | Seasonal / vacation rentals onlyWi-Fi availability. | Yes |
<gym>Optional | Yes | No | Seasonal / vacation rentals onlyPresence of a gym. | Yes |
<beds>Optional | Integer | Seasonal / vacation rentals onlyNumber of sleeps. | 10 |
<pets>Optional | Yes | No | Seasonal / vacation rentals onlyWhether pets are allowed. | No |
<price_min_vac>Optional | Decimal | Seasonal / vacation rentals onlyMinimum weekly price in EUR. | 2500.00 |
<price_max_vac>Optional | Decimal | Seasonal / vacation rentals onlyMaximum weekly price in EUR. | 4500.00 |
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<sea_view>Optional | Yes | No | Assigns the Sea view filter. | Yes |
<waterfront>Optional | Yes | No | Assigns the Waterfront filter. | No |
<distances>Optional | XML element | Container for all distance values. | — |
<beach>Optional | Integer · metres | Distance from the beach. | 450 |
<shops>Optional | Integer · metres | Distance from shops. | 800 |
<airport>Optional | Integer · metres | Distance from the airport. | 25000 |
<station>Optional | Integer · metres | Distance from the railway station. | 5000 |
<city_center>Optional | Integer · metres | Distance from the city centre. | 1200 |
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<title_{lang}>Optional | Text | Property title for en, fr, it, es, pt, de, nl or ru. | Sea-view villa in Nice |
<text_{lang}>Required | Text · en, fr, it, es or pt | Property description. At least one source description is required. | Spacious villa with panoramic sea views. |
<photos>Required | XML element · max 30 | Container for property images; at least one photo is required. | — |
<photo>Required | Absolute HTTP(S) URL | Direct URL of one property image. | https://www.riviera-estates.com/images/A321z-1.jpg |
<plans>Optional | XML element · max 5 | Optional container for property floor plans, kept in feed order. | — |
<plan>Optional | HTTPS · JPG, PNG, WebP or PDF | HTTPS URL of a floor-plan image or PDF, up to 20 MB. For PDFs, only the first page is imported. | https://www.riviera-estates.com/plans/A321z-ground-floor.pdf |
<video_url>Optional | Absolute URL | Link to a hosted video, such as YouTube or Vimeo. | https://www.youtube.com/watch?v=example |
<virtual_tour_url>Optional | Absolute URL | Link to a virtual or 360° tour, such as Matterport or Theasys. | https://my.matterport.com/show/?m=example |
| Tag | Format / accepted value | Description | Example |
|---|---|---|---|
<ener_class>Optional | A, B, C, D, E, F or G | Energy performance class. | A |
<ener_value>Optional | Decimal | Energy performance value. | 32 |
<gas_class>Optional | A, B, C, D, E, F or G | Greenhouse-gas emissions class. | B |
<gas_value>Optional | Decimal | Greenhouse-gas emissions value. | 21 |
<co-ownership_status>Optional | Yes | No | Properties located in France onlyWhether the property is in a condominium (French Alur law). | No |
<condominium_fees>Optional | Decimal · annual | Properties located in France onlyAnnual condominium fees (French Alur law). | 2400.00 |
<num_units>Optional | Integer | Properties located in France onlyNumber of condominium units or lots (French Alur law). | 18 |
<fees_purchaser>Optional | Decimal · percent | Properties located in France onlyPurchaser fees including tax, as a percentage (French Alur law). | 4.5 |
Use this as a structural reference, replace all example values, and repeat the property element for each active listing.
<?xml version="1.0" encoding="UTF-8"?>
<properties>
<agency>
<name>Real Estate Agency</name>
<email>[email protected]</email>
<phone>+33 4 94 00 00 00</phone>
<nationality>France</nationality>
<address>123 Main Street</address>
<zipcode>06000</zipcode>
<city>Nice</city>
<website>https://www.realestateagency.com</website>
<logo>https://www.realestateagency.com/static/logo.png</logo>
</agency>
<property>
<reference>A321z</reference>
<last_update>2026-10-23</last_update>
<contact_phone>+33 4 94 00 00 00</contact_phone>
<type_transaction>vacation rentals</type_transaction>
<type>Villa</type>
<latitude>43.710173</latitude>
<longitude>7.261953</longitude>
<zip_code>06000</zip_code>
<city>Nice</city>
<area>Alpes-Maritimes</area>
<country>France</country>
<price>2500</price>
<currency>EUR</currency>
<price_visible>Yes</price_visible>
<area_useful>180</area_useful>
<area_plot>230</area_plot>
<year>1995</year>
<floors>3</floors>
<rooms>8</rooms>
<bedrooms>6</bedrooms>
<bathroom>2</bathroom>
<shower_room>1</shower_room>
<garages>2</garages>
<terraces>2</terraces>
<balconies>1</balconies>
<orientation>S, SW</orientation>
<kitchen>2</kitchen>
<kitchen_fitted>2</kitchen_fitted>
<kitchen_US>1</kitchen_US>
<kitchen_independent>1</kitchen_independent>
<garden>Yes</garden>
<air_conditioning>Yes</air_conditioning>
<lift>Yes</lift>
<parking>2</parking>
<swimming_pool>Yes</swimming_pool>
<cellar>Yes</cellar>
<wifi>Yes</wifi>
<gym>Yes</gym>
<beds>10</beds>
<pets>Yes</pets>
<price_min_vac>2500.00</price_min_vac>
<price_max_vac>4500.00</price_max_vac>
<sea_view>Yes</sea_view>
<waterfront>No</waterfront>
<distances>
<beach>400</beach>
<shops>350</shops>
<airport>21000</airport>
<station>12000</station>
<city_center>2000</city_center>
</distances>
<title_en>Sea-view holiday villa in Nice</title_en>
<text_en>A bright holiday villa with panoramic sea views, generous living spaces, a landscaped garden and a private swimming pool near the beaches of Nice.</text_en>
<title_fr>Villa de vacances avec vue mer à Nice</title_fr>
<text_fr>Une villa de vacances lumineuse avec vue panoramique sur la mer, de beaux volumes, un jardin paysager et une piscine privée à proximité des plages de Nice.</text_fr>
<title_it>Villa vacanze con vista mare a Nizza</title_it>
<text_it>Una luminosa villa per vacanze con vista panoramica sul mare, ampi spazi, giardino paesaggistico e piscina privata vicino alle spiagge di Nizza.</text_it>
<title_es>Villa de vacaciones con vistas al mar en Niza</title_es>
<text_es>Una luminosa villa de vacaciones con vistas panorámicas al mar, amplios espacios, jardín y piscina privada cerca de las playas de Niza.</text_es>
<title_pt>Moradia de férias com vista mar em Nice</title_pt>
<text_pt>Uma luminosa moradia de férias com vista panorâmica para o mar, espaços amplos, jardim e piscina privada perto das praias de Nice.</text_pt>
<title_de>Ferienvilla mit Meerblick in Nizza</title_de>
<text_de>Eine helle Ferienvilla mit Panoramablick auf das Meer, großzügigen Wohnbereichen, Garten und privatem Pool nahe den Stränden von Nizza.</text_de>
<title_nl>Vakantievilla met zeezicht in Nice</title_nl>
<text_nl>Een lichte vakantievilla met panoramisch zeezicht, ruime leefruimtes, een aangelegde tuin en een privézwembad vlak bij de stranden van Nice.</text_nl>
<title_ru>Вилла для отдыха с видом на море в Ницце</title_ru>
<text_ru>Светлая вилла для отдыха с панорамным видом на море, просторными комнатами, садом и частным бассейном рядом с пляжами Ниццы.</text_ru>
<photos>
<photo>https://www.realestateagency.com/images/A321z-1.jpg</photo>
<photo>https://www.realestateagency.com/images/A321z-2.jpg</photo>
</photos>
<plans>
<plan>https://www.realestateagency.com/plans/A321z-ground-floor.pdf</plan>
<plan>https://www.realestateagency.com/plans/A321z-first-floor.jpg</plan>
</plans>
<video_url>https://www.youtube.com/watch?v=example</video_url>
<virtual_tour_url>https://my.matterport.com/show/?m=example</virtual_tour_url>
<ener_class>A</ener_class>
<ener_value>32</ener_value>
<gas_class>B</gas_class>
<gas_value>21</gas_value>
<co-ownership_status>Yes</co-ownership_status>
<condominium_fees>2400.00</condominium_fees>
<num_units>18</num_units>
<fees_purchaser>4.5</fees_purchaser>
</property>
</properties>This clean example incorporates the original v2 feed and the additions introduced through specification v2.2.
The documented evolution of the Mer et Demeures feed format.
Version 2.2 adds or completes the following optional fields:
<terraces>number of terraces<garden>garden availability<air_conditioning>air-conditioning availability<cellar>cellar availability<wifi>Wi-Fi availability for seasonal and vacation rentals<gym>gym availability for seasonal and vacation rentals<orientation>one or more cardinal property orientations<shower_room>number of shower rooms<balconies>number of balconies<kitchen_fitted>fitted-kitchen characteristic<kitchen_US>open-plan-kitchen characteristic<kitchen_independent>independent-kitchen characteristic<price_min_vac>minimum weekly rental price<price_max_vac>maximum weekly rental priceThe optional <plans> block was added. Each property can provide up to five floor plans in JPG, PNG, WebP or PDF format through HTTPS URLs; only the first page of a PDF is used.
The maximum number of photos allowed for each property increased from 10 to 30.
The specification changed the location filter from “Sea <20 km” to “Sea <50 km”. This automatic assignment is no longer applied.
The <video_url> and <virtual_tour_url> tags were added to the feed.
Run the pre-flight check, then consult the XSD for the formal structure and formats. If your feed differs, contact us before development so we can confirm compatibility.
Choose an XML file. We check its syntax, required fields, references, dates, descriptions, photos and floor-plan URLs directly in your browser.
Consult the complete schema in a new tab. The rule requiring at least one source description is checked by the validator above.
Send us the public feed URL and the agency name. We will configure the gateway and verify the first import.