Search Hotels - Detail Levels

The Detail Level field is used to set which level of details will returned in Search Hotels response.
The different detail levels are :

XML ValueJSON Value
Default0
Low1
Minimal2
NoPackages3
Meta4
LowNoTax5
MetaAdvanced6
MetaNoTax7
NoPackagesNoTax8
MetaExtended9

👍

NOTE:

  • Using the first three Detail Levels: Default, Low, or Minimal:
    Gets all data in the search results, and by using these options, there is no option to call GetPackages.
    Doing this is unrecommended as it is very resource consuming and bandwidth-heavy, as all the packages show up in the search results.
  • Feel free to try the different detail levels and see what works best for your specific situation and users.
    However, if you just want to get started, we recommend using:
    1. MetaExtended - as it is lightweight and returns all of the commonly needed fields. (Without Hotel data)
    2. MetaAdvanced - In case you need the Hotel data in the Search response.

IMOPRTANT NOTE !

To obtain the starred (⭐) parameters - Suppliers must provide room information during the Search step.

For suppliers who return room information in a separate call, the filtering options will not be available because this information is missing from the search step.


Detail Levels - Breakdown :

0️⃣

Default (0) -

Includes more detailed price breakdown, package information, and hotel information.
Not Recommended because of the large response size.

Can be used only with a single hotel ID .

Breakdown of tags received :

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • Packages
    • ContractId
    • HotelId
  • PackagePrice
    • Currency
    • FinalPrice
    • FinalPriceInSupplierCurrency
    • OriginalPrice
    • OriginalPriceInSupplierCurrency
    • SupplierCurrency
  • Rooms ⭐
    • SimplePrice
    • SupplierId
    • SupplierName
  • TrustYou (under TripAdvisor tag)

1️⃣

Low (1) -

Includes less detailed price breakdown on the package, Simple (final) Price including VAT (Tax).
Please notice that by using this detail level, you won't be able to fetch room content.

Breakdown of tags received:

  • Address
  • ChainCode
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • CityTax
  • Packages
    • SimplePrice
    • SupplierName
  • PackageID
  • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
    • SpecialDeals
  • SRSP
  • SimplePrice
  • Supplier name
  • StarRating

2️⃣

Minimal (2) -

Same as Low, excluding the the supplier name of the package.

Breakdown of tags received:

  • Address
  • DefaultImage
  • FullSize
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • Packages ⭐
    • SimplePrice
    • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
  • SimplePrice
  • StarRating

3️⃣

NoPackages (3) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price and highest package price per hotel, lowest and highest price including VAT (Tax).

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HighestPackagePrice ⭐
  • HotelReviews (Booking.com Rating)
  • HotelID
  • LowestPackagePrice ⭐
  • StarRating
  • TrustYou Reviews

4️⃣

Meta (4) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price of each supplier per hotel, lowest price including VAT (Tax).

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelID
  • HotelReviews (Booking.com Rating)
  • StarRating
  • SuppliersLowestPackagePrices ⭐
    • Supplier short name (Key)
    • Price including Tax (Value)

5️⃣

LowNoTax (5) -

Includes less detailed price breakdown on the package, Simple (final) Price excluding VAT (Tax).
Please notice that by using this detail level, you won't be able to fetch room content.

Breakdown of tags received:

  • Address
  • ChainCode
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelReviews (Booking.com Rating)
  • HotelID
  • PackageID
    • Refundability
  • Rooms ⭐
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
  • SRSP
  • SimplePrice
  • Supplier short name
  • StarRating
  • TrustYou Reviews

6️⃣

MetaAdvanced (6) -

Returns the recommended required hotel data.

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocations (Long + Lat)
  • HotelReviews (Booking.com Rating)
  • HotelID
  • PackagesMeta
    • Price
    • SupplierName
  • StarRating
  • TrustYou Reviews

7️⃣

MetaNoTax (7) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price of each supplier per hotel, lowest price excluding VAT (Tax).

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HotelReviews (Booking.com Rating)
  • HotelID
  • StarRating
  • SuppliersLowestPackagePrices
    • Supplier short name (Key)
    • Lowest supplier price (Value)

8️⃣

NoPackagesNoTax (8) -

Returns the minimum required hotel data.

Doesn't return any room information, only the lowest package price and highest package price per hotel, lowest and highest price excluding VAT (Tax).

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • CityTax
  • DisplayName
  • GeoLocation (Long + Lat)
  • HighestPackagePrice (⭐)
  • HotelReviews (Booking.com Rating)
  • HotelID
  • LowestPackagePrice
  • StarRating
  • TrustYou Reviews

9️⃣

MetaExtended (9) -

Returns the minimum required hotel and room data, and cheapest rate per hotel including VAT (Tax).

Breakdown of tags received:

  • AvailableBoards (⭐)
  • HotelReviews (Booking.com Rating)
  • HasFreeCancellationOption (⭐)
  • HotelID
  • Packages
    • ContractId
    • HotelId
    • PackagePrice
    • Currency
    • FinalPrice
    • FinalPriceInSupplierCurrency
    • OriginalPrice
    • OriginalPriceInSupplierCurrency
    • SupplierCurrency
  • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • Description
    • KidsAges
    • Price
    • SimplePrice
  • SupplierId
  • SupplierName
  • PaymentType (⭐)
  • PropertyType
  • RoomsKeywords (⭐)
  • TrustYou Reviews.