Solutions de descriptions d'hôtels
Pour chaque hôtel, une description courte, moyenne et longue, prête à vendre, en TR, EN, DE, RU et AR.
La fiche hôtel fournit les informations de base d'un hôtel dans des champs séparés et filtrables plutôt qu'en texte libre : type d'établissement, étoiles, nombre de chambres, horaires d'arrivée et de départ, plage et piscines, politique enfants et animaux, restaurants et coordonnées. Les informations de tous les fournisseurs sont regroupées sous le HM ID de l'hôtel, les valeurs contradictoires sont signalées ; les données sont livrées par API et fichiers dump.
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} L'heure d'arrivée, la politique enfants, le type de plage et le nombre de chambres sont des champs distincts : ils s'utilisent directement dans les filtres et les comparaisons.
Les informations d'un hôtel chez tous les fournisseurs sont réunies sous un seul HM ID. La page de l'hôtel ne change pas selon le fournisseur d'origine.
Quand les fournisseurs donnent des valeurs différentes pour un même champ, ce champ est signalé. Vous voyez dans la réponse quelle information attend une vérification.
Les descriptions d'hôtels sont produites à partir des mêmes données de fiche hôtel ; le texte et les champs ne se contredisent pas.
Informations brutes de l'établissement venant de deux fournisseurs
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.
[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz Fiche hôtel standard sous un HM ID
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} Données d'exemple ; l'hôtel et les codes ne correspondent à aucun établissement réel. Les champs sur lesquels les fournisseurs se contredisent (ici l'heure d'arrivée et le nombre de chambres) sont signalés par review_flags.
Les informations de tous les enregistrements fournisseurs rattachés au même HM ID sont rassemblées. Les données brutes sont conservées telles quelles, les modifications sont versionnées.
Les horaires, nombres, distances et politiques du texte libre sont convertis en champs séparés ; les formats d'heure, de distance et d'âge sont normalisés.
Lorsque les sources donnent des informations différentes, les valeurs sont comparées. Les champs incertains sont signalés et placés dans la file de vérification de l'équipe données.
La fiche hôtel est renvoyée par le endpoint GET /v1/hotels/{hm_id}/content ; tout l'inventaire est fourni dans des fichiers dump complets et delta quotidiens.
Les fournisseurs envoient souvent les informations de l’hôtel dans du texte libre. L’un écrit l’heure d’arrivée 14:00, l’autre 15:00 ; l’un annonce 412 chambres, l’autre 410. L’information sur la plage se perd au milieu d’une phrase, la limite d’âge des enfants arrive sous des formats différents. En l’état, on ne peut pas construire un filtre « hôtels avec plage privée de sable » ou « enfants de 0 à 6 ans gratuits ».
La fiche hôtel extrait ces informations dans des champs séparés et les rattache au HM ID de l’hôtel. La condition préalable est de mapper correctement l’hôtel ; vous trouverez la méthode dans le guide du mapping hôtelier et le produit sur la page mapping hôtelier.
| Groupe | Champs | Exemple de valeur |
|---|---|---|
| Informations sur l’établissement | Type d’établissement, étoiles, chaîne et marque, nombre de chambres et d’étages, année d’ouverture et de rénovation | Resort, 5 étoiles, 412 chambres |
| Politiques | Heures d’arrivée et de départ ; politique enfants, animaux, fumeurs et paiement | 14:00 / 12:00, gratuit de 0 à 6,99 ans |
| Plage et piscine | Type de plage, appartenant ou non à l’hôtel, distance ; nombre de piscines extérieures et intérieures | Sable, privée, 250 m ; 3 extérieures, 1 intérieure |
| Restauration | Restaurants, bars, types de cuisine, horaires d’ouverture | Restaurant de cuisine turque, bar de piscine |
| Contact et adresse | Adresse vérifiée, téléphone, e-mail, site web | [email protected] |
Les noms de champs et les valeurs sont indépendants de la langue ; dans votre interface, vous affichez le libellé dans votre langue.
Lorsque les fournisseurs donnent des valeurs différentes pour un même hôtel, les valeurs sont comparées. Les champs qui restent incertains sont signalés par review_flags et vérifiés par l’équipe données. Vous voyez ainsi dans la réponse quelle information est certaine et laquelle attend une vérification.
Les descriptions d’hôtels sont produites à partir des mêmes données de fiche hôtel ; un horaire ou une distance cités dans le texte ne contredisent pas la valeur du champ. La galerie photo de l’hôtel se trouve, elle, dans le service images d’hôtels ; si la fiche hôtel indique une plage mais qu’aucune image n’est étiquetée plage, vous pouvez générer une alerte pour l’équipe contenu.
La fiche hôtel est livrée par API REST hôtel par hôtel, et pour tout l’inventaire par des fichiers dump delta et complets quotidiens. Le paramètre include et les noms de champs de l’exemple sont un brouillon de l’API v1 ; le schéma définitif sera publié sur la page développeurs. Pour le périmètre et le tarif, vous pouvez demander un devis.
Requête
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
-H "X-API-Key: $HM_API_KEY" Réponse
{
"hm_id": "HM-1048213",
"factsheet": {
"property": { "type": "resort", "stars": 5, "room_count": 412 },
"policies": {
"check_in": "14:00",
"check_out": "12:00",
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false
},
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"dining": [
{ "type": "restaurant", "cuisine": "turkish" },
{ "type": "bar", "location": "pool" }
],
"contact": { "email": "[email protected]" },
"review_flags": ["check_in", "room_count"]
},
"updated_at": "2026-11-02T08:14:00Z"
} Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.
C'est la présentation des informations de base d'un hôtel (type d'établissement, étoiles, nombre de chambres, horaires d'arrivée et de départ, politiques, restauration, coordonnées) sous forme de champs structurés.
La description est un texte écrit pour être lu ; la fiche hôtel est un ensemble de champs séparés pour le filtrage et la comparaison. Toutes deux reposent sur les mêmes données vérifiées.
Les valeurs sont comparées ; les champs qui restent incertains sont signalés et vérifiés par l'équipe données. La réponse indique avec review_flags quels champs attendent une vérification.
Par API REST hôtel par hôtel, ou par fichiers dump complets et delta quotidiens pour tout l'inventaire (CSV, JSON). Un webhook de notification des changements est prévu.
Demander un devis
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.