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é.
La spécification technique complète pour connecter votre logiciel immobilier à notre portail international spécialisé dans l’immobilier en bord de mer.
<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>Fournissez un document XML complet à une adresse HTTPS stable. Notre importateur le contrôle chaque nuit et publie les biens éligibles.
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é.
Rendez le fichier complet accessible via une URL HTTPS stable.
Communiquez l’URL du flux à Mer et Demeures pour que nous configurions et testions l’import.
Envoyez toutes les annonces actives à chaque mise à jour. Les annonces absentes du flux ne peuvent plus être maintenues sur le portail.
Chaque bien doit conserver une référence stable et unique. En cas de doublon, seule la première annonce est traitée.
Utilisez last_update au format AAAA-MM-JJ et modifiez-la dès que le contenu du bien change.
Fournissez un texte substantiel en anglais, français, italien, espagnol ou portugais. Les langues manquantes sont traduites automatiquement.
Fournissez au moins une URL d’image directement accessible. Une annonce peut contenir jusqu’à 30 photos.
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.
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.
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<properties>Obligatoire | XML element | Élément racine contenant toutes les annonces et, facultativement, les informations de l’agence. | — |
<agency>Recommandé | XML element | Conteneur facultatif facilitant l’identification du flux. | — |
<name>Recommandé | Text | Nom de l’agence utilisé pour identifier le flux lors de la configuration et de l’assistance. | Riviera Estates |
<email>Facultatif | E-mail de contact de l’agence. | [email protected] | |
<phone>Facultatif | Text / phone | Téléphone de l’agence. | +33 4 94 00 00 00 |
<nationality>Facultatif | Text | Pays de l’agence. | France |
<address>Facultatif | Text | Adresse de l’agence. | 24 avenue de la Mer |
<zipcode>Facultatif | Alphanumeric | Code postal de l’agence. | 06000 |
<city>Facultatif | Text | Ville de l’agence. | Nice |
<website>Facultatif | Absolute URL | Site web de l’agence. | https://www.riviera-estates.com |
<logo>Facultatif | Absolute URL | URL directe du logo de l’agence. | https://www.riviera-estates.com/logo.png |
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<property>Obligatoire | XML element | Conteneur répété pour chaque annonce active. | — |
<reference>Obligatoire | Text / alphanumeric | Tout identifiant stable et unique provenant de votre système ; aucun préfixe ni format imposé. | A321z |
<last_update>Obligatoire | YYYY-MM-DD | Date de dernière modification du contenu de l’annonce. | 2026-10-23 |
<contact_phone>Facultatif | Text / phone | Téléphone utilisé pour les demandes ; celui du compte est utilisé par défaut. | +33 4 94 00 00 00 |
<type_transaction>Obligatoire | sale | seasonal rentals | vacation rentals | Type 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>Obligatoire | Apartment, Villa, Property, House, Plot of land, Island, Castle, Business, Building, New construction | Typologie du bien. | Villa |
<latitude>Facultatif | Decimal | Latitude du bien. | 43.7102 |
<longitude>Facultatif | Decimal | Longitude du bien. | 7.2620 |
<zip_code>Facultatif | Alphanumeric | Code postal du bien. | 06000 |
<city>Obligatoire | Text | Ville du bien. | Nice |
<area>Facultatif | Text | Subdivision administrative supérieure à la ville : région, département, etc. | Provence-Alpes-Côte d’Azur |
<country>Obligatoire | Text | Pays du bien. | France |
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<price>Obligatoire | Decimal | Prix du bien. | 2600000.00 |
<currency>Facultatif | EUR, USD, GBP, RUB, CHF… | Code ISO de la devise ; EUR par défaut. | EUR |
<price_visible>Facultatif | Yes | No | Indique si le prix est visible ; Oui par défaut. | Yes |
<area_useful>Recommandé | Decimal | Superficie habitable en mètres carrés, lorsqu’elle s’applique. | 240.50 |
<area_plot>Facultatif | Decimal | Superficie du terrain en mètres carrés. | 1800 |
<year>Facultatif | Integer (YYYY) | Année de construction. | 2021 |
<floors>Facultatif | Integer | Étage auquel se situe le bien ou l’appartement. | 3 |
<rooms>Facultatif | Integer | Nombre de pièces. | 8 |
<bedrooms>Recommandé | Integer | Nombre de chambres pour les biens résidentiels. | 5 |
<bathroom>Recommandé | Integer | Nombre de salles de bains pour les biens résidentiels. | 3 |
<shower_room>Facultatif | Integer | Nombre de salles d’eau ou de douche. | 1 |
<garages>Facultatif | Integer | Nombre de garages. | 2 |
<terraces>Facultatif | Integer | Nombre de terrasses. | 2 |
<balconies>Facultatif | Integer | Nombre de balcons. | 2 |
<orientation>Facultatif | N, NE, E, SE, S, SW, W, NW · comma-separated | Une ou plusieurs orientations cardinales du bien. | S, SW |
<kitchen>Facultatif | Integer | Nombre de cuisines. | 1 |
<kitchen_fitted>Facultatif | Integer | Nombre de cuisines équipées. | 1 |
<kitchen_US>Facultatif | Integer | Nombre de cuisines américaines. | 0 |
<kitchen_independent>Facultatif | Integer | Nombre de cuisines indépendantes. | 1 |
<garden>Facultatif | Yes | No | Présence d’un jardin. | Yes |
<air_conditioning>Facultatif | Yes | No | Présence de la climatisation. | Yes |
<lift>Facultatif | Yes | No | Présence d’un ascenseur. | Yes |
<parking>Facultatif | Integer | Nombre de places de parking. | 2 |
<swimming_pool>Facultatif | Yes | No | Présence d’une piscine. | Yes |
<cellar>Facultatif | Yes | No | Présence d’une cave. | Yes |
<wifi>Facultatif | Yes | No | Location saisonnière uniquementDisponibilité du Wi-Fi. | Yes |
<gym>Facultatif | Yes | No | Location saisonnière uniquementPrésence d’une salle de sport. | Yes |
<beds>Facultatif | Integer | Location saisonnière uniquementNombre de couchages. | 10 |
<pets>Facultatif | Yes | No | Location saisonnière uniquementIndique si les animaux sont autorisés. | No |
<price_min_vac>Facultatif | Decimal | Location saisonnière uniquementPrix minimum par semaine, en EUR. | 2500.00 |
<price_max_vac>Facultatif | Decimal | Location saisonnière uniquementPrix maximum par semaine, en EUR. | 4500.00 |
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<sea_view>Facultatif | Yes | No | Attribue le filtre Vue mer. | Yes |
<waterfront>Facultatif | Yes | No | Attribue le filtre Pieds dans l’eau. | No |
<distances>Facultatif | XML element | Conteneur de toutes les distances. | — |
<beach>Facultatif | Integer · metres | Distance de la plage. | 450 |
<shops>Facultatif | Integer · metres | Distance des commerces. | 800 |
<airport>Facultatif | Integer · metres | Distance de l’aéroport. | 25000 |
<station>Facultatif | Integer · metres | Distance de la gare. | 5000 |
<city_center>Facultatif | Integer · metres | Distance du centre-ville. | 1200 |
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<title_{lang}>Facultatif | Text | Titre du bien pour en, fr, it, es, pt, de, nl ou ru. | Sea-view villa in Nice |
<text_{lang}>Obligatoire | Text · en, fr, it, es or pt | Description du bien. Au moins une description source est obligatoire. | Spacious villa with panoramic sea views. |
<photos>Obligatoire | XML element · max 30 | Conteneur des images du bien ; au moins une photo est obligatoire. | — |
<photo>Obligatoire | Absolute HTTP(S) URL | URL directe d’une image du bien. | https://www.riviera-estates.com/images/A321z-1.jpg |
<plans>Facultatif | XML element · max 5 | Conteneur facultatif des plans du bien, conservés dans l’ordre du flux. | — |
<plan>Facultatif | HTTPS · JPG, PNG, WebP or PDF | URL 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>Facultatif | Absolute URL | Lien vers une vidéo hébergée, par exemple YouTube ou Vimeo. | https://www.youtube.com/watch?v=example |
<virtual_tour_url>Facultatif | Absolute URL | Lien vers une visite virtuelle ou 360°, par exemple Matterport ou Theasys. | https://my.matterport.com/show/?m=example |
| Balise | Format / valeur acceptée | Description | Exemple |
|---|---|---|---|
<ener_class>Facultatif | A, B, C, D, E, F or G | Classe énergétique. | A |
<ener_value>Facultatif | Decimal | Valeur de la consommation énergétique. | 32 |
<gas_class>Facultatif | A, B, C, D, E, F or G | Classe d’émission de gaz à effet de serre. | B |
<gas_value>Facultatif | Decimal | Valeur des émissions de gaz à effet de serre. | 21 |
<co-ownership_status>Facultatif | Yes | No | Biens situés en France uniquementBien soumis au statut de la copropriété (loi Alur). | No |
<condominium_fees>Facultatif | Decimal · annual | Biens situés en France uniquementCharges annuelles de copropriété (loi Alur). | 2400.00 |
<num_units>Facultatif | Integer | Biens situés en France uniquementNombre de lots de la copropriété (loi Alur). | 18 |
<fees_purchaser>Facultatif | Decimal · percent | Biens situés en France uniquementHonoraires à la charge de l’acquéreur, TTC en pourcentage (loi Alur). | 4.5 |
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.
<?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.
L’évolution documentée du format de flux Mer et Demeures.
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 maximumLe 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.
Le nombre maximal de photos autorisées pour chaque annonce est passé de 10 à 30.
La spécification a remplacé le filtre « Mer <20 km » par « Mer <50 km ». Cette attribution automatique n’est plus appliquée.
Les balises <video_url> et <virtual_tour_url> ont été ajoutées au flux.
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é.
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.
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.
Envoyez-nous l’URL publique du flux et le nom de l’agence. Nous configurerons la passerelle et vérifierons le premier import.