Coming soon

Hotel amenities solutions

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.

What you gain

  • One dictionary

    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.

  • Multilingual input

    Amenity names arriving in Turkish, English, German or another language are tied to the same code.

  • Property, room and accessibility kept apart

    Property amenities such as a pool, room amenities such as A/C, and accessibility information arrive in separate fields.

  • Shared dictionary with room content

    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.

  • On top of matched hotels

    Amenities will run on the HM ID infrastructure, where 3.5 million hotels worldwide are matched.

Before and after

Amenity names from three suppliers for the same hotel

supplier_amenities.csv
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-1048213 amenities
{
  "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.

How it works

  1. 1

    Collecting amenity names

    The property and room amenities sent by suppliers are gathered under the HM ID determined by hotel mapping.

  2. 2

    Converting to standard codes

    Different names such as "Free WiFi", "WLAN kostenlos" and "Ücretsiz kablosuz internet" are tied to a single amenity code.

  3. 3

    Splitting into property and room

    Each amenity is assigned to the property or room level; accessibility information is kept in separate fields.

  4. 4

    Verification and updates

    The data team verifies uncertain matches. Amenities are returned from the API, and changes arrive through delta dumps.

What do hotel amenities solve?

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.

Product status

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.

Coverage

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.

Where is it used?

  • Search filters: Filters such as “with a private beach”, “with an aqua park” or “pet-friendly” work with the same data across all sources.
  • Hotel comparison: Users compare hotels on the same amenity list.
  • Accessibility information: Hotels and rooms suited to guests with disabilities are shown clearly from separate fields.

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.

Early access

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.

What is hotel mapping? The complete guide

API example

Request

API v1 draft: requesting hotel amenities
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
  -H "X-API-Key: $HM_API_KEY"

Response

200 OK (draft 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.

Frequently asked questions

When will hotel amenities launch?

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.

Which amenities are covered?

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.

Why is amenity mapping needed?

Suppliers send the same amenity under different names. Without a standard code, filters miss some hotels or show the wrong ones.

Are room amenities tied to each room type separately?

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.

Is hotel mapping required for amenities?

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

Get your tailored quote

Send your request in three steps; we will email the quote to your work address. The request is non-binding.

  1. 1 Select solutions
  2. 2 Select suppliers
  3. 3 Leave your contact details