Room content solutions
Adds a multilingual description, size, capacity, bed layout and view to every standard room type.
Hotel amenities turns the different names suppliers send for the same amenity ("Free WiFi", "WLAN kostenlos", "Ücretsiz kablosuz internet") into a single standard code and ties it to the hotel's HM ID. Property amenities, room amenities and accessibility information are kept in separate fields. The product will launch soon; you can apply for early access from the quote page.
{
"hm_id": "HM-1048213",
"amenities_in": 7,
"amenities_unique": 4,
"amenities": [
{ "code": "wifi_free", "level": "hotel", "suppliers": ["A", "B", "C"] },
{ "code": "pool_outdoor", "level": "hotel", "suppliers": ["A", "C"] },
{ "code": "beach_private", "level": "hotel", "suppliers": ["B"] },
{ "code": "air_conditioning", "level": "room", "suppliers": ["C"] }
]
} Amenities from all suppliers are gathered in one code set; a "hotels with a private beach" filter works the same whichever source the data comes from.
Amenity names arriving in Turkish, English, German or another language are tied to the same code.
Property amenities such as a pool, room amenities such as A/C, and accessibility information arrive in separate fields.
Room amenities come from the same dictionary as the room content product, so a room type's amenities never contradict the hotel's amenity list.
Amenities will run on the HM ID infrastructure, where 3.5 million hotels worldwide are matched.
Amenity names from three suppliers for the same hotel
supplier,hotel_code,amenity
A,HTL-88213,Free WiFi
B,40917,WLAN kostenlos
C,TR-ANT-551,Ücretsiz kablosuz internet
A,HTL-88213,Outdoor pool
C,TR-ANT-551,Açık yüzme havuzu
B,40917,Privatstrand
C,TR-ANT-551,Klima (odalarda) Amenities converted to standard codes
{
"hm_id": "HM-1048213",
"amenities_in": 7,
"amenities_unique": 4,
"amenities": [
{ "code": "wifi_free", "level": "hotel", "suppliers": ["A", "B", "C"] },
{ "code": "pool_outdoor", "level": "hotel", "suppliers": ["A", "C"] },
{ "code": "beach_private", "level": "hotel", "suppliers": ["B"] },
{ "code": "air_conditioning", "level": "room", "suppliers": ["C"] }
]
} Sample data; the hotel and codes do not belong to a real property. Field names and amenity codes are an API v1 draft.
The property and room amenities sent by suppliers are gathered under the HM ID determined by hotel mapping.
Different names such as "Free WiFi", "WLAN kostenlos" and "Ücretsiz kablosuz internet" are tied to a single amenity code.
Each amenity is assigned to the property or room level; accessibility information is kept in separate fields.
The data team verifies uncertain matches. Amenities are returned from the API, and changes arrive through delta dumps.
Suppliers send the same amenity under different names: one file says “Free WiFi”, another “WLAN kostenlos”, and a third “Ücretsiz kablosuz internet”. A pool sometimes arrives as “Outdoor pool” and sometimes only as “POOL”. Without a standard code, a “hotels with a private beach” filter misses some hotels, and the amenity list of the same hotel changes depending on the supplier.
Hotel amenities ties these names to a single code dictionary. For details on the concept, see the amenity mapping glossary page. Amenities are part of static hotel data, and for them to merge correctly, the records of the same hotel first have to be gathered under one HM ID through hotel mapping. The general framework is in the hotel mapping guide.
Hotel amenities will launch soon. This page describes how the product will work; the field names, amenity codes and endpoints in the examples are an API v1 draft and may change.
| Group | Sample amenities | Sample code |
|---|---|---|
| Property amenities | Pool, spa, private beach, aqua park, fitness, parking, meeting room | pool_outdoor, beach_private |
| Room amenities | A/C, balcony, minibar, safe, coffee machine, bathtub | air_conditioning, minibar |
| Accessibility | Accessible facilities, elevator, accessible room | elevator |
Codes are language-independent; in your interface you show the name in your own language.
Amenities specific to a room type will come from the same dictionary as the room content product. Points around the hotel such as a beach or airport are not amenities but location and POI data.
When the product launches, amenities will be delivered in the API together with the hotel content response, and in dump files for the whole inventory. For early access, coverage and pricing, you can request a quote.
Request
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Response
{
"hm_id": "HM-1048213",
"amenities": {
"hotel": [
{ "code": "pool_outdoor", "name": "Açık havuz" },
{ "code": "beach_private", "name": "Özel plaj" },
{ "code": "spa", "name": "Spa" },
{ "code": "wifi_free", "name": "Ücretsiz Wi-Fi" }
],
"room": [
{ "code": "air_conditioning", "name": "Klima" },
{ "code": "minibar", "name": "Minibar" }
],
"accessibility": [
{ "code": "elevator", "name": "Asansör" }
]
}
} Code samples are illustrative; field names may change in the v1 release.
Hotel amenities will launch soon; the exact date has not been shared yet. You can write to us from the quote page for early access.
Property amenities such as pool, spa, private beach, aqua park, fitness, parking and meeting room; room amenities such as A/C, balcony, minibar, safe, coffee machine and bathtub; and accessibility, elevator and accessible room information.
Suppliers send the same amenity under different names. Without a standard code, filters miss some hotels or show the wrong ones.
Amenities specific to a room type will arrive in the room content product, together with the standard room ID. Both products use the same amenity dictionary.
Yes. Amenities from different suppliers can only be merged once the records of the same hotel have been gathered under a single HM ID.
Request a quote
Send your request in three steps; we will email the quote to your work address. The request is non-binding.