Skip to content

Content Catalog

Static content endpoints. Updated daily. Use for cache-friendly hotel content, meal plans, and city catalogs.

Method Path Purpose
GET /content-catalog/hotels List all available hotels (basic info)
GET /content-catalog/hotels/{hotelId} Full detail of one hotel
GET /content-catalog/mealplans All meal plans
GET /content-catalog/cities All cities

All require Authorization: Bearer <access_token>.


Returns the list of hotels available to your channel.

{
"hotels": [
{
"id": 100007,
"name": "Beachscape Kin Ha Villas & Suites Cancún",
"giataId": "50540",
"hotelBedsID": "8540",
"expediaIDRapid": "895806"
}
],
"total": 2
}
  • Sync hotel inventory daily.
  • Cross-reference IDs with Giata, HotelBeds, Expedia EPS Rapid.

Returns full hotel content.

Param Type Description
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/..." }
]
}
Field Notes
category Star rating as string (“3.0”, “4.5”, “5.0”, etc.)
giataId / hotelBedsID / expediaIDRapid Mapping IDs for Giata, HotelBeds and Expedia EPS Rapid. Returned by this detail endpoint, not only by GET /content-catalog/hotels. Present in all three verified samples.
geolocationX Longitude — note the unusual axis name
geolocationY Latitude
countryA2 ISO 3166-1 alpha-2 country code. Use it to match by country.
country Display name, not normalized. Match by country with countryA2 instead. See Data quality.
zipCode May arrive as an empty string ("") rather than as an absent field.
description May contain HTML (<br />, <p>): observed with tags in one sample and as plain text with no tags in another. Line breaks may be \n or \r\n. Tags are not always balanced. Sanitize before rendering.
attributes[] Array of objects with attributeId (int), title (string) and uri (string). Observed with 6 entries in one sample and empty in the other two. uri is a Spanish slug ("3-estrellas-mas", "plan-europeo", "plan-todo-incluido") while title is English ("3 stars or more", "Without food", "All inclusive"), with language left at its default — uri does not follow the language of the request. Classify by attributeId, not by title or uri.
alerts[] Observed always empty. The populated shape is not documented yet.
totalRooms Integer whose semantics are not defined. It does not consistently match rooms.length: it matched exactly in two samples and differs in a third (94 against 77 entries). It is not the hotel’s room count either — the description text of that same property mentions 169. Do not display it to travelers and do not use it to size inventory.
checkIn / checkOut (hotel level) Time of day, not a date. The format varies by hotel: both HH:MM and HH:MM:SS observed. See Time formats.
services[].serviceId Observed as 0 on every service in all three samples. Not usable as an identifier.
services[].description Optional and frequently absent — present in one sample, absent in the other two, where every service carried only serviceId, name and hasExtraCharge.
rooms[].checkIn Optional — may be absent. Shapes observed: HH:MM, HH:MM:SS, and the range HH:MM-HH:MM (e.g. "15:00-23:59", "15:00-00:00", "15:00-15:00"). The range is a window, not a single time. See Time formats.
rooms[].checkOut Optional — may be absent. Shapes observed: HH:MM, HH:MM:SS, and the range HH:MM-HH:MM (e.g. "11:00-11:00"). Ranges are not specific to checkIn. See Time formats.
rooms[].roomID Content catalog ID. Do not assume it matches the rooms[].id returned by /1.0/hotels/rates.
rooms[].amenities[] Array of plain strings, not of objects. May arrive empty or with dozens of entries depending on the hotel. The strings are not normalized — see Data quality.
rooms[].picture Plain string with the room photo URL. May be empty (""). Distinct field from rooms[].image.
rooms[].image Object with cloudUri (string) and photoId (int). Structured alternative to rooms[].picture. In practice both may be empty.
rooms[].maxOccupancy Maximum number of guests allowed in the room.
rooms[].bedType Free text, not normalized. Observed: "Subject to availability", "2 Twin Beds", "KING SIZE BED", "Single bed 80-130 width (x2)".
rooms[].bathroomType Bathroom type (e.g. "Private bathroom").
rooms[].smokingPolicy Smoking policy (e.g. "Non-Smoking").
gallery[].photoID Observed as a real ID in one sample and as 0 on every entry in the other two. Not reliable for identifying a photo.
gallery[].extension Optional. Present in one sample, absent in the other two. Presence correlates with the image URL scheme: one storage scheme exposes the ID in the path, the other uses a GUID.
Field Observed shapes
checkIn / checkOut (hotel level) HH:MM (e.g. "15:00"), HH:MM:SS (e.g. "15:00:00")
rooms[].checkIn HH:MM, HH:MM:SS, the range HH:MM-HH:MM (e.g. "15:00-23:59", "15:00-00:00", "15:00-15:00"), or absent
rooms[].checkOut HH:MM, HH:MM:SS, the range HH:MM-HH:MM (e.g. "11:00-11:00"), or absent

No shape predominates. One sample carried no seconds at all, at either level; another carried HH:MM:SS. Expect the shape to vary by hotel and by entry.

The range form is a window, not a single time, and it is not specific to checkIn: in one sample 68 of 77 rooms returned "11:00-11:00" for rooms[].checkOut. Its upper bound is not stable — "23:59", "00:00" and the start value itself have all been observed as the closing bound, and a range can be degenerate ("15:00-15:00", "11:00-11:00"). The lower bound is the only part that reads consistently across all three, which is what supports taking it.

Treat these values as opaque display strings unless you need to compute with them. If you do compute: check for presence, match against every shape above, and take the lower bound of the range.

rooms[] can contain several entries that describe the same physical room, each with its own roomID. In one hotel, rooms[] had 98 entries with 70 distinct names, where "2 Twin Premium Oceanfront" appears three times, with roomID 20133744, 20175437 and 27854023.

Hotel content is assembled from more than one source and the entries are not deduplicated in the response. There is no field today that indicates which source an entry comes from, so the duplicates cannot be reconciled from the response.

The pattern is not specific to one property or one country. In a second hotel, the 63 entries fall into four blocks, distinguishable only by incidental differences in shape and vocabulary:

rooms[].checkIn Rooms Amenity vocabulary
15:00 7 "Vanity mirror", "TV LCD"
(absent) 6 room names in Spanish
15:00-00:00 45 "King-size bed 150-183 width (x1)"
15:00-23:59 5 "Composting", "LED light bulbs"

Entries also repeat inside a single block, not only across blocks. In a third property — 77 entries in three blocks — "SEA VIEW OR PARTIAL SEA VIEW" appears three times, with roomID 4198203, 8426536 and 8426554, all three carrying the same time format and the same amenity vocabulary; "DOUBLE SEA VIEW", "QUADRUPLE SEA VIEW" and "TRIPLE SEA VIEW" each appear twice within that same block. The duplication is therefore not explained by the mix of sources alone.

What this means when you map rooms:

  • rooms[] is not a canonical list of room types.
  • rooms.length is not the number of room types, nor the number of physical rooms.
  • Matching by name collapses distinct roomIDs; matching by roomID produces duplicates in the partner catalog.
  • The array is not ordered by roomID. In the second hotel the last five roomIDs break ascending order, and in the third the last two do (22502906, 22502908) — consistent with entries being concatenated block by block. Do not assume any ordering in rooms[].

photos[] and gallery[] carry the same images. Element-by-element equality — photos being exactly the list of gallery[].cloudUri — was verified in two samples: 102 URLs in one, 50 in the other.

Consume gallery[] and ignore photos[]. gallery[] never carries less, but it does not always carry more: in two samples it added nothing over photos[], because extension was absent and every photoID was 0.

That duplication is close to a quarter of the response weight (~98 KB in the larger sample) — worth accounting for when syncing large catalogs.

Values arrive from the content sources with limited normalization. Treat every text field as untrusted input.

Field Observed value Note
rooms[].amenities[] "Electronic key " Trailing whitespace. Trim.
rooms[].amenities[] "Satellite TV " Trailing whitespace, same as "Electronic key ".
rooms[].amenities[] "($)Internet access" Cost marker embedded in the text.
rooms[].amenities[] "Base para iPod" Mixed language inside an English response.
rooms[].amenities[] "Number of bedrooms", "Smoking rooms" Attribute labels with no associated value, not amenities.
rooms[].bedType "Sujetas a disponibilidad" Mixed language: coexists with "Subject to availability" in the same English response.
telHotel "++84 0297 3683999" Duplicated + prefix.
telHotel "+52998891-5650" Country code not separated from the number.
country "Viet nam" Unnormalized display name. Use countryA2 to match by country.
address "KHU DU LICH BAI DAI " Trailing whitespace. Trim.
zipCode "" Empty string instead of an absent field.
  • rooms[].amenities[]: do not use the string as a key, and do not assume a closed vocabulary. The set of values varies between content sources.
  • telHotel: normalize before validating or dialing. The format is not consistent between hotels.
Code HTTP Message
1001 404 hotel not found
1002 400 hotelId must be an integer

Param Type Description
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
}
Code Description (en-us)
E Room Only
L Breakfast
A American breakfast
B Buffet breakfast
F Breakfast & dinner included
G Breakfast, lunch & dinner included
I All Inclusive

(Codes vary by hotel — always cross-reference with GET /content-catalog/mealplans.)


{
"cities": [
{ "idCity": 1, "name": "Acapulco", "country": "Mexico", "countryA2": "MX" },
{ "idCity": 2, "name": "Aguascalientes", "country": "Mexico", "countryA2": "MX" }
],
"total": 2
}
  • Filter / segment hotels by city.
  • Match idCity with hotel detail responses.

Since Content Catalog data is updated daily, cache responses for 24h:

  • /content-catalog/hotels — full sync once per day.
  • /content-catalog/hotels/{id} — cache per hotel, refresh weekly unless dynamic content needed.
  • /content-catalog/mealplans — cache for 7 days.
  • /content-catalog/cities — cache for 30 days.