Mer et Demeures : Grand choix d’appartements vue mer et de maisons en bord de mer en France et à l’étranger
Blog
Flag
|EUR
Mer et Demeures : Grand choix d’appartements vue mer et de maisons en bord de mer en France et à l’étranger
Mer et Demeures : Grand choix d’appartements vue mer et de maisons en bord de mer en France et à l’étranger
Mon compte
Flag
| EUR
Mer et Demeures : Grand choix d’appartements vue mer et de maisons en bord de mer en France et à l’étranger
Intégration agence · Flux XML

Publiez votre flux immobilier sur Mer et Demeures

La spécification technique complète pour connecter votre logiciel immobilier à notre portail international spécialisé dans l’immobilier en bord de mer.

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

De votre logiciel à notre portail

Fournissez un document XML complet à une adresse HTTPS stable. Notre importateur le contrôle chaque nuit et publie les biens éligibles.

01

Générez

Exportez toutes les annonces actives dans un seul fichier XML. Bien que facultatif, un bloc <agency> contenant le nom de l’agence est fortement recommandé.

02

Hébergez

Rendez le fichier complet accessible via une URL HTTPS stable.

03

Transmettez

Communiquez l’URL du flux à Mer et Demeures pour que nous configurions et testions l’import.

Avant de commencer

Cinq règles pour un import fiable

01

Flux complet

Envoyez toutes les annonces actives à chaque mise à jour. Les annonces absentes du flux ne peuvent plus être maintenues sur le portail.

02

Référence unique

Chaque bien doit conserver une référence stable et unique. En cas de doublon, seule la première annonce est traitée.

03

Date de mise à jour fiable

Utilisez last_update au format AAAA-MM-JJ et modifiez-la dès que le contenu du bien change.

04

Au moins une description

Fournissez un texte substantiel en anglais, français, italien, espagnol ou portugais. Les langues manquantes sont traduites automatiquement.

05

Médias accessibles

Fournissez au moins une URL d’image directement accessible. Une annonce peut contenir jusqu’à 30 photos.

Attribution des filtres bord de mer

Renseignez sea_view et waterfront lorsqu’ils s’appliquent. Le filtre « Plage à pied » peut être déduit de la distance à la plage ou des mots-clés de la description.

Cycle de mise à jour nocturne

  1. 1Flux complet récupéré
  2. 2Références comparées
  3. 3Annonces nouvelles ou modifiées traitées
  4. 4Annonces éligibles publiées
Référence du schéma

Toutes les balises XML documentées

Les balises marquées Obligatoire doivent contenir une valeur. Celles marquées Recommandé améliorent l’identification du flux, la qualité des annonces et les filtres de recherche. Les balises facultatives peuvent être omises.

01Document et agenceL’élément racine et les informations facultatives sur l’agence qui fournit le flux.
BaliseFormat / valeur acceptéeDescriptionExemple
<properties>ObligatoireXML elementÉlément racine contenant toutes les annonces et, facultativement, les informations de l’agence.—
<agency>RecommandéXML elementConteneur facultatif facilitant l’identification du flux.—
<name>RecommandéTextNom de l’agence utilisé pour identifier le flux lors de la configuration et de l’assistance.Riviera Estates
<email>FacultatifEmailE-mail de contact de l’agence.[email protected]
<phone>FacultatifText / phoneTéléphone de l’agence.+33 4 94 00 00 00
<nationality>FacultatifTextPays de l’agence.France
<address>FacultatifTextAdresse de l’agence.24 avenue de la Mer
<zipcode>FacultatifAlphanumericCode postal de l’agence.06000
<city>FacultatifTextVille de l’agence.Nice
<website>FacultatifAbsolute URLSite web de l’agence.https://www.riviera-estates.com
<logo>FacultatifAbsolute URLURL directe du logo de l’agence.https://www.riviera-estates.com/logo.png
02Identité et localisation du bienIdentifiants stables et informations géographiques utilisées pour rattacher le bien à nos localités.
BaliseFormat / valeur acceptéeDescriptionExemple
<property>ObligatoireXML elementConteneur répété pour chaque annonce active.—
<reference>ObligatoireText / alphanumericTout identifiant stable et unique provenant de votre système ; aucun préfixe ni format imposé.A321z
<last_update>ObligatoireYYYY-MM-DDDate de dernière modification du contenu de l’annonce.2026-10-23
<contact_phone>FacultatifText / phoneTéléphone utilisé pour les demandes ; celui du compte est utilisé par défaut.+33 4 94 00 00 00
<type_transaction>Obligatoiresale | seasonal rentals | vacation rentalsType de transaction immobilière.Les transactions restent limitées à la vente et aux locations saisonnières ou de vacances ; ce flux ne crée pas d’annonces avec une transaction de programme neuf.sale
<type>ObligatoireApartment, Villa, Property, House, Plot of land, Island, Castle, Business, Building, New constructionTypologie du bien.Villa
<latitude>FacultatifDecimalLatitude du bien.43.7102
<longitude>FacultatifDecimalLongitude du bien.7.2620
<zip_code>FacultatifAlphanumericCode postal du bien.06000
<city>ObligatoireTextVille du bien.Nice
<area>FacultatifTextSubdivision administrative supérieure à la ville : région, département, etc.Provence-Alpes-Côte d’Azur
<country>ObligatoireTextPays du bien.France
03Prix et caractéristiquesInformations commerciales et principales caractéristiques affichées sur la fiche du bien.
BaliseFormat / valeur acceptéeDescriptionExemple
<price>ObligatoireDecimalPrix du bien.2600000.00
<currency>FacultatifEUR, USD, GBP, RUB, CHF…Code ISO de la devise ; EUR par défaut.EUR
<price_visible>FacultatifYes | NoIndique si le prix est visible ; Oui par défaut.Yes
<area_useful>RecommandéDecimalSuperficie habitable en mètres carrés, lorsqu’elle s’applique.240.50
<area_plot>FacultatifDecimalSuperficie du terrain en mètres carrés.1800
<year>FacultatifInteger (YYYY)Année de construction.2021
<floors>FacultatifIntegerÉtage auquel se situe le bien ou l’appartement.3
<rooms>FacultatifIntegerNombre de pièces.8
<bedrooms>RecommandéIntegerNombre de chambres pour les biens résidentiels.5
<bathroom>RecommandéIntegerNombre de salles de bains pour les biens résidentiels.3
<shower_room>FacultatifIntegerNombre de salles d’eau ou de douche.1
<garages>FacultatifIntegerNombre de garages.2
<terraces>FacultatifIntegerNombre de terrasses.2
<balconies>FacultatifIntegerNombre de balcons.2
<orientation>FacultatifN, NE, E, SE, S, SW, W, NW · comma-separatedUne ou plusieurs orientations cardinales du bien.S, SW
<kitchen>FacultatifIntegerNombre de cuisines.1
<kitchen_fitted>FacultatifIntegerNombre de cuisines équipées.1
<kitchen_US>FacultatifIntegerNombre de cuisines américaines.0
<kitchen_independent>FacultatifIntegerNombre de cuisines indépendantes.1
<garden>FacultatifYes | NoPrésence d’un jardin.Yes
<air_conditioning>FacultatifYes | NoPrésence de la climatisation.Yes
<lift>FacultatifYes | NoPrésence d’un ascenseur.Yes
<parking>FacultatifIntegerNombre de places de parking.2
<swimming_pool>FacultatifYes | NoPrésence d’une piscine.Yes
<cellar>FacultatifYes | NoPrésence d’une cave.Yes
<wifi>FacultatifYes | NoLocation saisonnière uniquementDisponibilité du Wi-Fi.Yes
<gym>FacultatifYes | NoLocation saisonnière uniquementPrésence d’une salle de sport.Yes
<beds>FacultatifIntegerLocation saisonnière uniquementNombre de couchages.10
<pets>FacultatifYes | NoLocation saisonnière uniquementIndique si les animaux sont autorisés.No
<price_min_vac>FacultatifDecimalLocation saisonnière uniquementPrix minimum par semaine, en EUR.2500.00
<price_max_vac>FacultatifDecimalLocation saisonnière uniquementPrix maximum par semaine, en EUR.4500.00
04Filtres bord de mer et distancesAttributs liés au littoral et distances aux services de proximité, exprimées en mètres.
BaliseFormat / valeur acceptéeDescriptionExemple
<sea_view>FacultatifYes | NoAttribue le filtre Vue mer.Yes
<waterfront>FacultatifYes | NoAttribue le filtre Pieds dans l’eau.No
<distances>FacultatifXML elementConteneur de toutes les distances.—
<beach>FacultatifInteger · metresDistance de la plage.450
<shops>FacultatifInteger · metresDistance des commerces.800
<airport>FacultatifInteger · metresDistance de l’aéroport.25000
<station>FacultatifInteger · metresDistance de la gare.5000
<city_center>FacultatifInteger · metresDistance du centre-ville.1200
05Contenus multilingues et médiasTitres et descriptions dans huit langues, suivis d’URL de médias directement accessibles.
BaliseFormat / valeur acceptéeDescriptionExemple
<title_{lang}>FacultatifTextTitre du bien pour en, fr, it, es, pt, de, nl ou ru.Sea-view villa in Nice
<text_{lang}>ObligatoireText · en, fr, it, es or ptDescription du bien. Au moins une description source est obligatoire.Spacious villa with panoramic sea views.
<photos>ObligatoireXML element · max 30Conteneur des images du bien ; au moins une photo est obligatoire.—
<photo>ObligatoireAbsolute HTTP(S) URLURL directe d’une image du bien.https://www.riviera-estates.com/images/A321z-1.jpg
<plans>FacultatifXML element · max 5Conteneur facultatif des plans du bien, conservés dans l’ordre du flux.—
<plan>FacultatifHTTPS · JPG, PNG, WebP or PDFURL HTTPS d’un plan au format image ou PDF, jusqu’à 20 Mo. Pour les PDF, seule la première page est importée.https://www.riviera-estates.com/plans/A321z-ground-floor.pdf
<video_url>FacultatifAbsolute URLLien vers une vidéo hébergée, par exemple YouTube ou Vimeo.https://www.youtube.com/watch?v=example
<virtual_tour_url>FacultatifAbsolute URLLien vers une visite virtuelle ou 360°, par exemple Matterport ou Theasys.https://my.matterport.com/show/?m=example
06Performance énergétique et loi AlurValeurs de performance énergétique et champs facultatifs relatifs à la copropriété en France.
BaliseFormat / valeur acceptéeDescriptionExemple
<ener_class>FacultatifA, B, C, D, E, F or GClasse énergétique.A
<ener_value>FacultatifDecimalValeur de la consommation énergétique.32
<gas_class>FacultatifA, B, C, D, E, F or GClasse d’émission de gaz à effet de serre.B
<gas_value>FacultatifDecimalValeur des émissions de gaz à effet de serre.21
<co-ownership_status>FacultatifYes | NoBiens situés en France uniquementBien soumis au statut de la copropriété (loi Alur).No
<condominium_fees>FacultatifDecimal · annualBiens situés en France uniquementCharges annuelles de copropriété (loi Alur).2400.00
<num_units>FacultatifIntegerBiens situés en France uniquementNombre de lots de la copropriété (loi Alur).18
<fees_purchaser>FacultatifDecimal · percentBiens situés en France uniquementHonoraires à la charge de l’acquéreur, TTC en pourcentage (loi Alur).4.5
Point de départ

Un exemple XML propre et valide

Utilisez-le comme référence de structure, remplacez toutes les valeurs d’exemple et répétez l’élément property pour chaque annonce active.

Ouvrir l’exemple XML↗
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>

Cet exemple propre reprend le flux v2 original et les ajouts introduits jusqu’à la spécification v2.2.

Évolution de la spécification

Historique des versions

L’évolution documentée du format de flux Mer et Demeures.

v2.2Spécification actuelle

Caractéristiques de recherche et correspondances d’import

La version 2.2 ajoute ou complète les champs facultatifs suivants :

  • <terraces>nombre de terrasses
  • <garden>présence d’un jardin
  • <air_conditioning>présence de la climatisation
  • <cellar>présence d’une cave
  • <wifi>disponibilité du Wi-Fi pour les locations saisonnières ou de vacances
  • <gym>présence d’une salle de sport pour les locations saisonnières ou de vacances
  • <orientation>une ou plusieurs orientations cardinales du bien
  • <shower_room>nombre de salles d’eau
  • <balconies>nombre de balcons
  • <kitchen_fitted>présence d’une cuisine équipée
  • <kitchen_US>présence d’une cuisine américaine
  • <kitchen_independent>présence d’une cuisine indépendante
  • <price_min_vac>prix hebdomadaire minimum
  • <price_max_vac>prix hebdomadaire maximum
v2.1

Plans du bien

Le bloc facultatif <plans> a été ajouté. Chaque annonce peut fournir jusqu’à 5 plans aux formats JPG, PNG, WebP ou PDF via des URL HTTPS ; seule la première page d’un PDF est utilisée.

v2

Davantage de photos par annonce

Le nombre maximal de photos autorisées pour chaque annonce est passé de 10 à 30.

v1.1

Évolution historique du filtre littoral

La spécification a remplacé le filtre « Mer <20 km » par « Mer <50 km ». Cette attribution automatique n’est plus appliquée.

v1

Vidéo et visites virtuelles

Les balises <video_url> et <virtual_tour_url> ont été ajoutées au flux.

Validation et assistance

Contrôlez le flux avant sa connexion

Lancez le pré-contrôle, puis consultez le XSD pour la structure et les formats formels. Si votre flux diffère, contactez-nous avant le développement afin de confirmer sa compatibilité.

Contrôle avant envoi

Validez un flux XML

Choisissez un fichier XML. Nous contrôlons sa syntaxe, les champs obligatoires, les références, les dates, les descriptions, les photos et les URL des plans directement dans votre navigateur.

Les fichiers sont contrôlés dans votre navigateur et ne sont pas envoyés à Mer et Demeures.
XSD 1.0

Schéma de validation du flux

Consultez le schéma complet dans un nouvel onglet. La règle exigeant au moins une description source reste contrôlée par le validateur ci-dessus.

Ouvrir le schéma XSD↗

Votre flux est prêt ?

Envoyez-nous l’URL publique du flux et le nom de l’agence. Nous configurerons la passerelle et vérifierons le premier import.

Autre possibilité : [email protected]