Content Catalog
Static content endpoints. Updated daily. Use for cache-friendly hotel content, meal plans, and city catalogs.
Endpoints
Section titled “Endpoints”| 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>.
GET /content-catalog/hotels
Section titled “GET /content-catalog/hotels”Returns the list of hotels available to your channel.
Response
Section titled “Response”{ "hotels": [ { "id": 100007, "name": "Beachscape Kin Ha Villas & Suites Cancún", "giataId": "50540", "hotelBedsID": "8540", "expediaIDRapid": "895806" } ], "total": 2}Use cases
Section titled “Use cases”- Sync hotel inventory daily.
- Cross-reference IDs with Giata, HotelBeds, Expedia EPS Rapid.
GET /content-catalog/hotels/{hotelId}
Section titled “GET /content-catalog/hotels/{hotelId}”Returns full hotel content.
Query params
Section titled “Query params”| Param | Type | Description |
|---|---|---|
language |
string | en-us (default), es-mx, es-co, pt-br |
Response (excerpt)
Section titled “Response (excerpt)”{ "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/..." } ]}Notable fields
Section titled “Notable fields”| 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. |
Time formats
Section titled “Time formats”| 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.
Duplicate room entries
Section titled “Duplicate room entries”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.lengthis not the number of room types, nor the number of physical rooms.- Matching by
namecollapses distinctroomIDs; matching byroomIDproduces duplicates in the partner catalog. - The array is not ordered by
roomID. In the second hotel the last fiveroomIDs 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 inrooms[].
photos vs gallery
Section titled “photos vs gallery”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.
Data quality
Section titled “Data quality”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.
Errors
Section titled “Errors”| Code | HTTP | Message |
|---|---|---|
| 1001 | 404 | hotel not found |
| 1002 | 400 | hotelId must be an integer |
GET /content-catalog/mealplans
Section titled “GET /content-catalog/mealplans”Query params
Section titled “Query params”| Param | Type | Description |
|---|---|---|
language |
string | en-us (default), es-mx |
Response
Section titled “Response”{ "mealPlans": [ { "code": "A", "description": "American breakfast" }, { "code": "AA", "description": "Imperial Christmas and New Years Eve" }, { "code": "AB", "description": "Romantic Getaway" } ], "total": 3}Common meal plan codes
Section titled “Common meal plan codes”| 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.)
GET /content-catalog/cities
Section titled “GET /content-catalog/cities”Response
Section titled “Response”{ "cities": [ { "idCity": 1, "name": "Acapulco", "country": "Mexico", "countryA2": "MX" }, { "idCity": 2, "name": "Aguascalientes", "country": "Mexico", "countryA2": "MX" } ], "total": 2}Use cases
Section titled “Use cases”- Filter / segment hotels by city.
- Match
idCitywith hotel detail responses.
Caching strategy
Section titled “Caching strategy”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.

