Soluciones de descripciones de hoteles
Para cada hotel, una descripción corta, media y larga, lista para vender, en TR, EN, DE, RU y AR.
La ficha de hotel ofrece los datos básicos de un hotel en campos separados y filtrables en lugar de texto libre: tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, playa y piscinas, política de niños y mascotas, restaurantes y datos de contacto. La información de todos los proveedores se reúne bajo el HM ID del hotel, los valores contradictorios se marcan; los datos se entregan por API y archivos 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"]
}
} La hora de entrada, la política de niños, el tipo de playa y el número de habitaciones son campos independientes, por lo que se usan directamente en filtros y comparaciones.
La información de un hotel en todos los proveedores se reúne bajo un único HM ID. La página del hotel no cambia según el proveedor del que se llegue.
Cuando los proveedores dan valores distintos para el mismo campo, el campo se marca. En la respuesta ve qué datos están pendientes de revisión.
Las descripciones de hoteles se generan a partir de los mismos datos de la ficha; el texto y los campos no se contradicen.
Datos brutos del establecimiento de dos proveedores
[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 Ficha de hotel estándar bajo 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"]
}
} Datos de ejemplo; el hotel y los códigos no pertenecen a un establecimiento real. Los campos en los que los proveedores se contradicen (aquí, la hora de entrada y el número de habitaciones) se marcan con review_flags.
Se reúnen los datos de todos los registros de proveedores vinculados al mismo HM ID. Los datos brutos se conservan tal cual y los cambios se versionan.
Los horarios, cifras, distancias y políticas del texto libre se convierten en campos separados; se normalizan los formatos de hora, distancia y edad.
Cuando las fuentes dan información distinta, se comparan los valores. Los campos dudosos se marcan y pasan a la cola de revisión del equipo de datos.
La ficha de hotel se devuelve desde el endpoint GET /v1/hotels/{hm_id}/content; todo el inventario llega en archivos dump completos y delta diarios.
Los proveedores suelen enviar los datos del hotel dentro de texto libre. Uno escribe la hora de entrada como 14:00 y otro como 15:00; uno dice 412 habitaciones y otro 410. La información de la playa se pierde dentro de una frase y el límite de edad de los niños llega en formatos distintos. Así no se puede montar un filtro de “hoteles con playa de arena privada” o “niños de 0 a 6 años gratis”.
La ficha de hotel extrae estos datos a campos separados y los vincula al HM ID del hotel. El requisito previo es mapear bien el hotel; puede consultar el método en la guía de mapeo hotelero y el producto en la página de mapeo hotelero.
| Grupo | Campos | Valor de ejemplo |
|---|---|---|
| Datos del establecimiento | Tipo de establecimiento, estrellas, cadena y marca, número de habitaciones y plantas, año de apertura y de renovación | Resort, 5 estrellas, 412 habitaciones |
| Políticas | Horario de entrada y salida; política de niños, mascotas, tabaco y pago | 14:00 / 12:00, gratis de 0 a 6,99 años |
| Playa y piscina | Tipo de playa, si es del hotel, distancia; número de piscinas exteriores e interiores | Arena, del hotel, 250 m; 3 exteriores, 1 interior |
| Restauración | Restaurantes, bares, tipos de cocina, horarios de apertura | Restaurante de cocina turca, bar en la piscina |
| Contacto y dirección | Dirección verificada, teléfono, correo electrónico, sitio web | [email protected] |
Los nombres y valores de los campos son independientes del idioma; en su interfaz muestra la etiqueta en su propio idioma.
Cuando los proveedores dan valores distintos para el mismo hotel, se comparan los valores. Los campos que siguen siendo dudosos se marcan con review_flags y los revisa el equipo de datos. Así ve en la respuesta qué información es segura y cuál está pendiente de revisión.
Las descripciones de hoteles se generan a partir de los mismos datos de la ficha; un horario o una distancia que aparezcan en el texto no contradicen el valor del campo. La galería de fotos del hotel está en el servicio de imágenes de hoteles; si la ficha indica que el hotel tiene playa y no hay ninguna imagen etiquetada como playa, puede generar una alerta para el equipo de contenido.
La ficha de hotel se entrega por API REST hotel a hotel y, para todo el inventario, con archivos completos y dump delta diarios. El parámetro include y los nombres de campo del ejemplo son un borrador de la API v1; el esquema definitivo se publicará en la página para desarrolladores. Para conocer el alcance y el precio, puede solicitar un presupuesto.
Solicitud
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
-H "X-API-Key: $HM_API_KEY" Respuesta
{
"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"
} Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1.
Es la presentación de los datos básicos de un hotel (tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, políticas, restauración, contacto) en campos estructurados.
La descripción es un texto escrito para leerse; la ficha de hotel son campos separados para filtrar y comparar. Ambas se basan en los mismos datos verificados.
Se comparan los valores; los campos que siguen siendo dudosos se marcan y los revisa el equipo de datos. En la respuesta, review_flags muestra qué campos están pendientes de revisión.
Por API REST hotel a hotel o, para todo el inventario, con archivos dump completos y delta diarios (CSV, JSON). Está previsto un webhook para notificar cambios.
Solicitar presupuesto
Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.