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é.
Endpoints
Sección titulada «Endpoints»| 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>.
GET /content-catalog/hotels
Sección titulada «GET /content-catalog/hotels»Devuelve la lista de hoteles disponibles para tu channel.
Respuesta
Sección titulada «Respuesta»{ "hotels": [ { "id": 100007, "name": "Beachscape Kin Ha Villas & Suites Cancún", "giataId": "50540", "hotelBedsID": "8540", "expediaIDRapid": "895806" } ], "total": 2}Casos de uso
Sección titulada «Casos de uso»- Sincronizar el inventario de hoteles a diario.
- Cruzar IDs con Giata, HotelBeds, Expedia EPS Rapid.
GET /content-catalog/hotels/{hotelId}
Sección titulada «GET /content-catalog/hotels/{hotelId}»Devuelve el contenido completo del hotel.
Query params
Sección titulada «Query params»| Parámetro | Tipo | Descripción |
|---|---|---|
language |
string | en-us (default), es-mx, es-co, pt-br |
Respuesta (extracto)
Sección titulada «Respuesta (extracto)»{ "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/..." } ]}Campos destacados
Sección titulada «Campos destacados»| 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. |
Time formats
Sección titulada «Time formats»| 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.
Duplicate room entries
Sección titulada «Duplicate room entries»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.lengthno equivale al número de tipos ni al de habitaciones físicas.- Hacer match por
namecolapsaroomIDs distintos; hacer match porroomIDgenera duplicados en el catálogo del partner. - El array no está ordenado por
roomID. En el segundo hotel los últimos cincoroomIDrompen 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 enrooms[].
photos vs gallery
Sección titulada «photos vs gallery»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.
Data quality
Sección titulada «Data quality»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.
Errores
Sección titulada «Errores»| Código | HTTP | Mensaje |
|---|---|---|
| 1001 | 404 | hotel not found |
| 1002 | 400 | hotelId must be an integer |
GET /content-catalog/mealplans
Sección titulada «GET /content-catalog/mealplans»Query params
Sección titulada «Query params»| Parámetro | Tipo | Descripción |
|---|---|---|
language |
string | en-us (default), es-mx |
Respuesta
Sección titulada «Respuesta»{ "mealPlans": [ { "code": "A", "description": "American breakfast" }, { "code": "AA", "description": "Imperial Christmas and New Years Eve" }, { "code": "AB", "description": "Romantic Getaway" } ], "total": 3}Códigos comunes de planes de alimentos
Sección titulada «Códigos comunes de planes de alimentos»| 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.)
GET /content-catalog/cities
Sección titulada «GET /content-catalog/cities»Respuesta
Sección titulada «Respuesta»{ "cities": [ { "idCity": 1, "name": "Acapulco", "country": "Mexico", "countryA2": "MX" }, { "idCity": 2, "name": "Aguascalientes", "country": "Mexico", "countryA2": "MX" } ], "total": 2}Casos de uso
Sección titulada «Casos de uso»- Filtrar / segmentar hoteles por ciudad.
- Relacionar
idCitycon las respuestas de detalle de hotel.
Estrategia de caché
Sección titulada «Estrategia de caché»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.

