Documentation

Dashboard Menu
Categories & category group

When you run either a hotels / hoteldetail operations, each of the hotels you receive will have a category value. This information has different standards for each country, so it’s difficult to retrieve a very specific definition for each of them. In case you have doubts, we recommend referring to each country standard to get specific information.

Due to these different standardizations for each country, there are up to 60 hotel categories that can be found on the categories request: https://api.hotelbeds.com/hotel-content-api/ /1.0/types/categories?fields=all&language=ENG&from=1&to=1000

Each category is sending the following information:

<category
    code = "1EST"
    simpleCode = "1"
    accommodationType = "HOTEL"
    group = "GRUPO1">
    <description>1 STAR</description>
</category>
<category
    code = "1LL"
    simpleCode = "1"
    accommodationType = "APARTMENT"
    group = "GRUPO7">
    <description>1 KEY</description>
</category>

There are a few items you should have in consideration when working with the categories:

  • description: Description of the category. This field is multilanguage.
  • simpleCode: This is a numeric value (from 0 to 5, being 5 the best rated / 0 pending classification). It might help you classifying different categories.
  • accomodationType: This is the property type which will use this category. Stars will be used for hotels, Keys will be used for apartments, etc. This is not mandatory and may be different on specific countries or hotel chains.
  • group: Used for simplication around mapping. Similar categories are grouped together on 7 groups. More info can be detailed by running the groupcategories request: https://api.hotelbeds.com/hotel-content-api/1.0/types/groupcategories?fields=all &from=1&to=1000
    • GRUPO1: Includes 1-star hotels
    • GRUPO2: Includes 2-star hotels, standard, mini hotels, residences and rural hotels.
    • GRUPO3: Includes 3-star hotels and rural hotels.
    • GRUPO4: Includes 4-star hotels, 4-superior and 4 deluxe, boutiques, villas, historic hotels, rural hotels, lodges, farmhouses and Portuguese pousadas.
    • GRUPO5: Includes 5-star hotel and 5 star luxury.
    • GRUPO6: Includes pensions, hostels, bed and breakfasts, boarding house, guesthouses and rural hostels.
    • GRUPO7: Includes campings, apartments and aparthotels