Room mapping solutions
Breaks room names into type, class, view, bed and capacity; groups the same room under one room ID.
Room content adds a multilingual description and structured information to every standard room type created by room mapping (e.g. HM-1048213-R03): square metres, maximum adults and children, extra bed, bed layout, view and room amenities. The guest sees clearly what they are buying. The product will launch soon; you can apply for early access from the quote page.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} The content is specific to the room type being sold, not the hotel's general promotion; it arrives together with the standard room ID.
Room descriptions are prepared in Turkish, English, German, Russian and Arabic.
Capacity and bed layout arrive in separate fields; they can be used directly in filters and occupancy checks.
Descriptions are produced quickly with AI and checked by editors.
Information about the same room from three suppliers
supplier,hotel_code,room_code,room_info
A,HTL-88213,DBLSV-B,"Sea view room, 28 m2, max 3 pax"
B,40917,DZMB,"Zimmer ca. 28 qm, Meerblick, Balkon, Klimaanlage"
C,TR-ANT-551,STD-DNZ,"Deniz manzaralı balkonlu oda, 2 yetişkin + 1 çocuk, minibar" Room content tied to the standard room type
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} Sample data; the hotel, room details and codes do not belong to a real property. Field names are an API v1 draft.
Room mapping ties the suppliers' room names to the standard room ID linked to the hotel's HM ID.
Square metres, capacity, bed layout and view are collected from all sources and turned into separate fields.
AI produces a short and a long description specific to the room type; editors check it.
Room content arrives in the API response and in the bulk file, together with the standard room ID.
On a room selection screen, the guest often sees only a room name and a price. To understand the difference between a “Standard room” and a “Superior room”, how many people the room sleeps or whether it has a balcony, they have to read the hotel’s general description. Suppliers send this information in different formats: one writes “28 m2, max 3 pax”, another buries the square metres inside German free text, and another gives nothing.
Room content gathers this information in a single record for every standard room type. The product will launch soon; this page describes how it will work, and the fields and endpoints in the examples are an API v1 draft.
Room content uses the standard room IDs created by room mapping. Because “Dbl Sea View Balcony”, “DZ Meerblick Balkon” and “Standart Oda Deniz Manzaralı Balkonlu” are tied to the same room ID, the information from all three suppliers merges on the same room. You can read how room types are standardized in the what is room mapping guide, and the general framework in the hotel mapping guide.
| Field | What it describes | Sample |
|---|---|---|
| Room description | Short and long text specific to the room type | TR, EN, DE, RU, AR |
| Size | The size of the room | 28 m² |
| Capacity | Maximum adults and children, extra bed | 2 adults + 1 child |
| Bed layout | Bed type | Double, two separate beds |
| View and position | What is seen from the window, where the room is | Sea view, garden floor |
| Room amenities | Standard amenity codes | Balcony, A/C, minibar |
Room amenities come from the same dictionary as the hotel amenities product. Used together with room images, the description, measurements and photos meet on the same room ID. For the term, see the room mapping glossary page.
For early access, coverage and pricing, you can request a quote.
Request
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=content&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Response
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda."
}
}
]
} Code samples are illustrative; field names may change in the v1 release.
Room content will launch soon; the exact date has not been shared yet. You can write to us from the quote page for early access.
Yes. The content is tied to the standard room ID that room mapping provides. Until room types are standardized, information from different suppliers cannot be merged on the same room.
A multilingual short and long room description, square metres, maximum adults and children, extra bed, bed layout, view and room amenities.
Room amenities come from the same standard dictionary as the hotel amenities product. So a room type's amenities and the hotel's amenity list use the same codes.
No. Room content is static room data. Price and availability come from the supplier to your system.
Request a quote
Send your request in three steps; we will email the quote to your work address. The request is non-binding.