Ir al contenido

Content Catalog

Endpoints de contenido estático. Se actualizan a diario. Úsalos para contenido de hoteles, planes de alimentos y catálogos de ciudades aptos para caché.

Método Ruta Propósito
GET /content-catalog/hotels Lista todos los hoteles disponibles (info básica)
GET /content-catalog/hotels/{hotelId} Detalle completo de un hotel
GET /content-catalog/mealplans Todos los planes de alimentos
GET /content-catalog/cities Todas las ciudades

Todos requieren Authorization: Bearer <access_token>.


Devuelve la lista de hoteles disponibles para tu channel.

{
"hotels": [
{
"id": 100007,
"name": "Beachscape Kin Ha Villas & Suites Cancún",
"giataId": "50540",
"hotelBedsID": "8540",
"expediaIDRapid": "895806"
}
],
"total": 2
}
  • Sincronizar el inventario de hoteles a diario.
  • Cruzar IDs con Giata, HotelBeds, Expedia EPS Rapid.

Devuelve el contenido completo del hotel.

Parámetro Tipo Descripción
language string en-us (default), es-mx, es-co, pt-br
{
"id": 100010,
"name": "Aquamarina Beach",
"category": "3.0",
"address": "Blvr Kukulcán km 4.5 Zona Hotelera Cancun",
"idCity": 26,
"city": "Cancún",
"destination": "Cancún",
"countryA2": "MX",
"country": "Mexico",
"zipCode": "77500",
"totalRooms": 94,
"geolocationX": "-86.79060280323029",
"geolocationY": "21.146537512859727",
"hotelBedsID": "4001",
"expediaIDRapid": "895724",
"giataId": "391934",
"telHotel": "+52998849-4606",
"description": "...",
"checkIn": "15:00",
"checkOut": "11:00",
"alerts": [],
"photos": ["https://img.cdnpth.com/..."],
"services": [
{ "serviceId": 0, "name": "Children's pool", "hasExtraCharge": false }
],
"rooms": [
{
"roomID": 26888541,
"name": "Standard Run of House",
"amenities": [],
"picture": "",
"image": { "cloudUri": "", "photoId": 0 },
"maxOccupancy": 4,
"bedType": "Subject to availability",
"bathroomType": "Private bathroom",
"smokingPolicy": "Non-Smoking",
"checkIn": "15:00",
"checkOut": "11:00"
},
{
"roomID": 4198203,
"name": "SEA VIEW OR PARTIAL SEA VIEW",
"amenities": ["Shower", "Balcony", "Satellite TV ", "Smoking rooms"],
"picture": "",
"image": { "cloudUri": "", "photoId": 0 },
"maxOccupancy": 4,
"bedType": "King-size bed 150-183 width (x1) or Double bed 131-150 width (x1)",
"bathroomType": "Private bathroom",
"smokingPolicy": "Non-Smoking",
"checkIn": "15:00-15:00",
"checkOut": "11:00-11:00"
}
],
"attributes": [
{ "attributeId": 3, "title": "3 stars or more", "uri": "3-estrellas-mas" }
],
"gallery": [
{ "photoID": 0, "cloudUri": "https://img.cdnpth.com/..." }
]
}
Campo Notas
category Categoría en estrellas como string (“3.0”, “4.5”, “5.0”, etc.)
giataId / hotelBedsID / expediaIDRapid IDs de mapeo para Giata, HotelBeds y Expedia EPS Rapid. Los devuelve este endpoint de detalle, no solo GET /content-catalog/hotels. Presentes en las tres muestras verificadas.
geolocationX Longitud — nota el nombre de eje inusual
geolocationY Latitud
countryA2 Código de país ISO 3166-1 alpha-2. Úsalo para hacer match por país.
country Nombre de display, no normalizado. Para hacer match por país usa countryA2. Ver Data quality.
zipCode Puede venir como string vacío ("") en lugar de venir ausente.
description Puede contener HTML (<br />, <p>): observado con etiquetas en una muestra y como texto plano sin etiquetas en otra. Los saltos de línea pueden ser \n o \r\n. Las etiquetas no siempre están balanceadas. Sanitiza antes de renderizar.
attributes[] Array de objetos con attributeId (int), title (string) y uri (string). Observado con 6 entradas en una muestra y vacío en las otras dos. El uri es un slug en español ("3-estrellas-mas", "plan-europeo", "plan-todo-incluido") mientras que el title viene en inglés ("3 stars or more", "Without food", "All inclusive"), con language en su valor por defecto: el uri no sigue el idioma de la petición. Clasifica por attributeId, no por title ni por uri.
alerts[] Observado siempre vacío. La forma poblada no está documentada aún.
totalRooms Entero cuya semántica no está definida. No coincide de forma consistente con rooms.length: coincidió exactamente en dos muestras y difiere en una tercera (94 contra 77 entradas). Tampoco corresponde al número de habitaciones del hotel: el texto de description de esa misma propiedad menciona 169. No lo muestres al viajero ni lo uses para dimensionar inventario.
checkIn / checkOut (nivel hotel) Hora del día, no una fecha. El formato varía por hotel: se observaron HH:MM y HH:MM:SS. Ver Time formats.
services[].serviceId Observado como 0 en todos los servicios de las tres muestras. No es utilizable como identificador.
services[].description Opcional y frecuentemente ausente: presente en una muestra, ausente en las otras dos, donde todos los servicios traían solo serviceId, name y hasExtraCharge.
rooms[].checkIn Opcional: puede venir ausente. Formas observadas: HH:MM, HH:MM:SS y el rango HH:MM-HH:MM (p. ej. "15:00-23:59", "15:00-00:00", "15:00-15:00"). El rango es una ventana, no una hora. Ver Time formats.
rooms[].checkOut Opcional: puede venir ausente. Formas observadas: HH:MM, HH:MM:SS y el rango HH:MM-HH:MM (p. ej. "11:00-11:00"). Los rangos no son exclusivos de checkIn. Ver Time formats.
rooms[].roomID ID del catálogo de contenido. No asumas que corresponde al rooms[].id que devuelve /1.0/hotels/rates.
rooms[].amenities[] Array de strings planos, no de objetos. Puede venir vacío o con decenas de entradas según el hotel. Las cadenas no están normalizadas — ver Data quality.
rooms[].picture String simple con la URL de la foto de la habitación. Puede estar vacío (""). Campo distinto de rooms[].image.
rooms[].image Objeto con cloudUri (string) y photoId (int). Alternativa estructurada a rooms[].picture. En la práctica ambos pueden estar vacíos.
rooms[].maxOccupancy Número máximo de huéspedes permitidos en la habitación.
rooms[].bedType Texto libre, no normalizado. Observado: "Subject to availability", "2 Twin Beds", "KING SIZE BED", "Single bed 80-130 width (x2)".
rooms[].bathroomType Tipo de baño (p. ej. "Private bathroom").
rooms[].smokingPolicy Política de fumado (p. ej. "Non-Smoking").
gallery[].photoID Observado con un ID real en una muestra y como 0 en todas las entradas de las otras dos. No es confiable para identificar una foto.
gallery[].extension Opcional. Presente en una muestra, ausente en las otras dos. Su presencia correlaciona con el esquema de URL de la imagen: un esquema de almacenamiento expone el ID en el path y el otro usa un GUID.
Campo Formas observadas
checkIn / checkOut (nivel hotel) HH:MM (p. ej. "15:00"), HH:MM:SS (p. ej. "15:00:00")
rooms[].checkIn HH:MM, HH:MM:SS, el rango HH:MM-HH:MM (p. ej. "15:00-23:59", "15:00-00:00", "15:00-15:00"), o ausente
rooms[].checkOut HH:MM, HH:MM:SS, el rango HH:MM-HH:MM (p. ej. "11:00-11:00"), o ausente

Ninguna forma predomina. Una muestra no traía segundos en ningún nivel; otra sí traía HH:MM:SS. Espera que la forma varíe por hotel y por entrada.

La forma de rango es una ventana, no una hora, y no es exclusiva de checkIn: en una muestra, 68 de 77 habitaciones devolvieron "11:00-11:00" en rooms[].checkOut. Su límite superior no es estable —se observaron como cierre "23:59", "00:00" y el propio valor de inicio— y el rango puede ser degenerado ("15:00-15:00", "11:00-11:00"). El límite inferior es la única parte que se lee de forma consistente en los tres casos, y eso es lo que sostiene tomarlo.

Trata estos valores como strings opacos de display salvo que necesites calcular con ellos. Si calculas: verifica la presencia, haz match contra todas las formas de arriba y toma el límite inferior del rango.

rooms[] puede contener varias entradas que describen la misma habitación física, cada una con su propio roomID. En un hotel, rooms[] tenía 98 entradas con 70 nombres distintos, donde "2 Twin Premium Oceanfront" aparece tres veces, con roomID 20133744, 20175437 y 27854023.

El contenido del hotel se compone de más de una fuente y las entradas no se deduplican en la respuesta. Hoy no existe un campo que indique de qué fuente viene cada entrada, por lo que los duplicados no pueden reconciliarse desde la respuesta.

El patrón no es específico de una propiedad ni de un país. En un segundo hotel, las 63 entradas se agrupan en cuatro bloques, distinguibles solo por diferencias incidentales de forma y vocabulario:

rooms[].checkIn Habitaciones Vocabulario de amenities
15:00 7 "Vanity mirror", "TV LCD"
(ausente) 6 nombres de habitación en español
15:00-00:00 45 "King-size bed 150-183 width (x1)"
15:00-23:59 5 "Composting", "LED light bulbs"

Las entradas también se repiten dentro de un mismo bloque, no solo entre bloques. En una tercera propiedad —77 entradas en tres bloques— "SEA VIEW OR PARTIAL SEA VIEW" aparece tres veces, con roomID 4198203, 8426536 y 8426554, las tres con el mismo formato de hora y el mismo vocabulario de amenities; "DOUBLE SEA VIEW", "QUADRUPLE SEA VIEW" y "TRIPLE SEA VIEW" aparecen dos veces cada uno dentro de ese mismo bloque. La duplicación, por lo tanto, no se explica solo por la mezcla de fuentes.

Consecuencias al mapear habitaciones:

  • rooms[] no es una lista canónica de tipos de habitación.
  • rooms.length no equivale al número de tipos ni al de habitaciones físicas.
  • Hacer match por name colapsa roomIDs distintos; hacer match por roomID genera duplicados en el catálogo del partner.
  • El array no está ordenado por roomID. En el segundo hotel los últimos cinco roomID rompen el orden ascendente, y en el tercero lo rompen los dos últimos (22502906, 22502908), lo que es consistente con entradas concatenadas bloque por bloque. No asumas ningún orden en rooms[].

photos[] y gallery[] transportan las mismas imágenes. La igualdad elemento por elemento —que photos sea exactamente la lista de gallery[].cloudUri— se verificó en dos muestras: 102 URLs en una, 50 en la otra.

Consume gallery[] e ignora photos[]. gallery[] nunca aporta menos, pero no siempre aporta más: en dos muestras no agregó nada sobre photos[], porque extension no venía y todos los photoID eran 0.

Esa duplicación es cerca de un cuarto del peso de la respuesta (~98 KB en la muestra más grande) — tenlo en cuenta al sincronizar catálogos grandes.

Los valores llegan desde las fuentes de contenido con normalización limitada. Trata todo campo de texto como entrada no confiable.

Campo Valor observado Nota
rooms[].amenities[] "Electronic key " Espacio final. Trimear.
rooms[].amenities[] "Satellite TV " Espacio final, igual que "Electronic key ".
rooms[].amenities[] "($)Internet access" Marcador de costo embebido en el texto.
rooms[].amenities[] "Base para iPod" Idioma mezclado dentro de una respuesta en inglés.
rooms[].amenities[] "Number of bedrooms", "Smoking rooms" Etiquetas de atributo sin valor asociado, no amenities.
rooms[].bedType "Sujetas a disponibilidad" Idioma mezclado: convive con "Subject to availability" en la misma respuesta en inglés.
telHotel "++84 0297 3683999" Prefijo + duplicado.
telHotel "+52998891-5650" Código de país sin separar del número.
country "Viet nam" Nombre de display no normalizado. Usa countryA2 para hacer match por país.
address "KHU DU LICH BAI DAI " Espacios finales. Trimear.
zipCode "" Cadena vacía en lugar de campo ausente.
  • rooms[].amenities[]: no uses la cadena como clave ni asumas un vocabulario cerrado. El conjunto de valores varía entre fuentes de contenido.
  • telHotel: normaliza antes de validar o discar. El formato no es consistente entre hoteles.
Código HTTP Mensaje
1001 404 hotel not found
1002 400 hotelId must be an integer

Parámetro Tipo Descripción
language string en-us (default), es-mx
{
"mealPlans": [
{ "code": "A", "description": "American breakfast" },
{ "code": "AA", "description": "Imperial Christmas and New Years Eve" },
{ "code": "AB", "description": "Romantic Getaway" }
],
"total": 3
}
Código Descripción (es-mx)
E Sin alimentos
L Desayuno
A Desayuno americano
B Desayuno bufet
F Desayuno y cena incluidos
G Desayuno, comida y cena
I Todo incluido

(Los códigos varían según el hotel — siempre crúzalos con GET /content-catalog/mealplans.)


{
"cities": [
{ "idCity": 1, "name": "Acapulco", "country": "Mexico", "countryA2": "MX" },
{ "idCity": 2, "name": "Aguascalientes", "country": "Mexico", "countryA2": "MX" }
],
"total": 2
}
  • Filtrar / segmentar hoteles por ciudad.
  • Relacionar idCity con las respuestas de detalle de hotel.

Dado que los datos del Content Catalog se actualizan a diario, cachea las respuestas por 24h:

  • /content-catalog/hotels — sincronización completa una vez al día.
  • /content-catalog/hotels/{id} — cachea por hotel, refresca semanalmente salvo que se necesite contenido dinámico.
  • /content-catalog/mealplans — cachea por 7 días.
  • /content-catalog/cities — cachea por 30 días.