Mer et Demeures : Great selection of sea view apartments and seaside houses in France and abroad
Blog
Flag
|EUR
Mer et Demeures : Great selection of sea view apartments and seaside houses in France and abroad
Mer et Demeures : Great selection of sea view apartments and seaside houses in France and abroad
My account
Flag
| EUR
Mer et Demeures : Great selection of sea view apartments and seaside houses in France and abroad
Agency integration · XML feed

Publish your property feed on Mer et Demeures

The complete technical specification for connecting your property software to our international seaside real-estate portal.

feed.xml
<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>
XML 1.0 · UTF-8

From your software to our portal

Provide one complete XML document at a stable HTTPS address. Our importer checks it every night and publishes eligible properties.

01

Generate

Export every active property in one XML file. Although optional, an <agency> block containing the agency name is strongly recommended.

02

Host

Expose the complete file through a stable HTTPS URL.

03

Send

Share the feed URL with Mer et Demeures so we can configure and test the import.

Before you begin

Five rules that make an import reliable

01

Complete feed

Send every active property on every update. Listings absent from the feed can no longer be maintained on the portal.

02

Unique reference

Each property must keep one stable, unique reference. If a duplicate occurs, only the first property is processed.

03

Meaningful update date

Use last_update in YYYY-MM-DD format and change it whenever the property content changes.

04

At least one description

Supply a substantial text in English, French, Italian, Spanish or Portuguese. Missing destination languages are translated automatically.

05

Usable media

Provide at least one directly accessible image URL. A property can contain up to 30 photos.

How seaside filters are assigned

Set sea_view and waterfront explicitly when applicable. “Beach walk” can be inferred from the beach distance or description keywords.

Nightly update lifecycle

  1. 1Full feed fetched
  2. 2References compared
  3. 3New or changed listings processed
  4. 4Eligible listings published
Schema reference

Every documented XML tag

Tags marked Required must contain a value. Recommended tags improve feed identification, listing completeness and search filtering. Optional tags may be omitted when unavailable.

01Document & agencyThe root element and optional information about the agency supplying the feed.
TagFormat / accepted valueDescriptionExample
<properties>RequiredXML elementRoot element containing all properties and, optionally, agency information.—
<agency>RecommendedXML elementOptional container that makes the feed easier to identify.—
<name>RecommendedTextAgency name used to identify the feed during setup and support.Riviera Estates
<email>OptionalEmailAgency contact email.[email protected]
<phone>OptionalText / phoneAgency phone number.+33 4 94 00 00 00
<nationality>OptionalTextAgency country.France
<address>OptionalTextAgency street address.24 avenue de la Mer
<zipcode>OptionalAlphanumericAgency postal code.06000
<city>OptionalTextAgency city.Nice
<website>OptionalAbsolute URLAgency website.https://www.riviera-estates.com
<logo>OptionalAbsolute URLDirect URL of the agency logo.https://www.riviera-estates.com/logo.png
02Property identity & locationStable identifiers and the geographic information used to match a property to our locations.
TagFormat / accepted valueDescriptionExample
<property>RequiredXML elementContainer repeated once for every active property.—
<reference>RequiredText / alphanumericAny stable, unique identifier from your system; no prefix or prescribed format.A321z
<last_update>RequiredYYYY-MM-DDDate when the property content last changed.2026-10-23
<contact_phone>OptionalText / phonePhone number used for enquiries; the account phone is used by default.+33 4 94 00 00 00
<type_transaction>Requiredsale | seasonal rentals | vacation rentalsReal-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>RequiredApartment, Villa, Property, House, Plot of land, Island, Castle, Business, Building, New constructionProperty category.Villa
<latitude>OptionalDecimalProperty latitude.43.7102
<longitude>OptionalDecimalProperty longitude.7.2620
<zip_code>OptionalAlphanumericProperty postal code.06000
<city>RequiredTextProperty city.Nice
<area>OptionalTextAdministrative division above the city: region, county or department.Provence-Alpes-Côte d’Azur
<country>RequiredTextProperty country.France
03Price & characteristicsCommercial information and the main features displayed on the property page.
TagFormat / accepted valueDescriptionExample
<price>RequiredDecimalProperty price.2600000.00
<currency>OptionalEUR, USD, GBP, RUB, CHF…ISO currency code; EUR is used when omitted.EUR
<price_visible>OptionalYes | NoWhether the price is visible; Yes by default.Yes
<area_useful>RecommendedDecimalLiving area in square metres, whenever applicable.240.50
<area_plot>OptionalDecimalPlot area in square metres.1800
<year>OptionalInteger (YYYY)Construction year.2021
<floors>OptionalIntegerFloor on which the property or apartment is located.3
<rooms>OptionalIntegerNumber of rooms.8
<bedrooms>RecommendedIntegerNumber of bedrooms for residential properties.5
<bathroom>RecommendedIntegerNumber of bathrooms for residential properties.3
<shower_room>OptionalIntegerNumber of shower rooms.1
<garages>OptionalIntegerNumber of garages.2
<terraces>OptionalIntegerNumber of terraces.2
<balconies>OptionalIntegerNumber of balconies.2
<orientation>OptionalN, NE, E, SE, S, SW, W, NW · comma-separatedOne or more cardinal orientations of the property.S, SW
<kitchen>OptionalIntegerNumber of kitchens.1
<kitchen_fitted>OptionalIntegerNumber of fitted kitchens.1
<kitchen_US>OptionalIntegerNumber of open-plan kitchens.0
<kitchen_independent>OptionalIntegerNumber of independent kitchens.1
<garden>OptionalYes | NoPresence of a garden.Yes
<air_conditioning>OptionalYes | NoPresence of air conditioning.Yes
<lift>OptionalYes | NoPresence of a lift.Yes
<parking>OptionalIntegerNumber of parking spaces.2
<swimming_pool>OptionalYes | NoPresence of a swimming pool.Yes
<cellar>OptionalYes | NoPresence of a cellar.Yes
<wifi>OptionalYes | NoSeasonal / vacation rentals onlyWi-Fi availability.Yes
<gym>OptionalYes | NoSeasonal / vacation rentals onlyPresence of a gym.Yes
<beds>OptionalIntegerSeasonal / vacation rentals onlyNumber of sleeps.10
<pets>OptionalYes | NoSeasonal / vacation rentals onlyWhether pets are allowed.No
<price_min_vac>OptionalDecimalSeasonal / vacation rentals onlyMinimum weekly price in EUR.2500.00
<price_max_vac>OptionalDecimalSeasonal / vacation rentals onlyMaximum weekly price in EUR.4500.00
04Seaside filters & distancesExplicit seaside attributes and distances to nearby services, expressed in metres.
TagFormat / accepted valueDescriptionExample
<sea_view>OptionalYes | NoAssigns the Sea view filter.Yes
<waterfront>OptionalYes | NoAssigns the Waterfront filter.No
<distances>OptionalXML elementContainer for all distance values.—
<beach>OptionalInteger · metresDistance from the beach.450
<shops>OptionalInteger · metresDistance from shops.800
<airport>OptionalInteger · metresDistance from the airport.25000
<station>OptionalInteger · metresDistance from the railway station.5000
<city_center>OptionalInteger · metresDistance from the city centre.1200
05Multilingual content & mediaTitles and descriptions for eight languages, followed by directly accessible media URLs.
TagFormat / accepted valueDescriptionExample
<title_{lang}>OptionalTextProperty title for en, fr, it, es, pt, de, nl or ru.Sea-view villa in Nice
<text_{lang}>RequiredText · en, fr, it, es or ptProperty description. At least one source description is required.Spacious villa with panoramic sea views.
<photos>RequiredXML element · max 30Container for property images; at least one photo is required.—
<photo>RequiredAbsolute HTTP(S) URLDirect URL of one property image.https://www.riviera-estates.com/images/A321z-1.jpg
<plans>OptionalXML element · max 5Optional container for property floor plans, kept in feed order.—
<plan>OptionalHTTPS · JPG, PNG, WebP or PDFHTTPS 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>OptionalAbsolute URLLink to a hosted video, such as YouTube or Vimeo.https://www.youtube.com/watch?v=example
<virtual_tour_url>OptionalAbsolute URLLink to a virtual or 360° tour, such as Matterport or Theasys.https://my.matterport.com/show/?m=example
06Energy performance & French Alur lawEnergy performance values and optional fields relating to French condominium law.
TagFormat / accepted valueDescriptionExample
<ener_class>OptionalA, B, C, D, E, F or GEnergy performance class.A
<ener_value>OptionalDecimalEnergy performance value.32
<gas_class>OptionalA, B, C, D, E, F or GGreenhouse-gas emissions class.B
<gas_value>OptionalDecimalGreenhouse-gas emissions value.21
<co-ownership_status>OptionalYes | NoProperties located in France onlyWhether the property is in a condominium (French Alur law).No
<condominium_fees>OptionalDecimal · annualProperties located in France onlyAnnual condominium fees (French Alur law).2400.00
<num_units>OptionalIntegerProperties located in France onlyNumber of condominium units or lots (French Alur law).18
<fees_purchaser>OptionalDecimal · percentProperties located in France onlyPurchaser fees including tax, as a percentage (French Alur law).4.5
Implementation starter

A clean, valid XML example

Use this as a structural reference, replace all example values, and repeat the property element for each active listing.

Open XML example↗
feed.xml
<?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.

Specification lifecycle

Version history

The documented evolution of the Mer et Demeures feed format.

v2.2Current specification

Search characteristics and importer mappings

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 price
v2.1

Floor plans

The 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.

v2

More property photos

The maximum number of photos allowed for each property increased from 10 to 30.

v1.1

Historical seaside filter update

The specification changed the location filter from “Sea <20 km” to “Sea <50 km”. This automatic assignment is no longer applied.

v1

Video and virtual tours

The <video_url> and <virtual_tour_url> tags were added to the feed.

Validation & support

Check the feed before connecting it

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.

Pre-flight check

Validate an XML feed

Choose an XML file. We check its syntax, required fields, references, dates, descriptions, photos and floor-plan URLs directly in your browser.

Files are checked in your browser and are not uploaded to Mer et Demeures.
XSD 1.0

Feed validation schema

Consult the complete schema in a new tab. The rule requiring at least one source description is checked by the validator above.

Open XSD schema↗

Ready to connect your feed?

Send us the public feed URL and the agency name. We will configure the gateway and verify the first import.

Alternatively: [email protected]