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 Value | JSON Value |
---|---|
Default | 0 |
Low | 1 |
Minimal | 2 |
NoPackages | 3 |
Meta | 4 |
LowNoTax | 5 |
MetaAdvanced | 6 |
MetaNoTax | 7 |
NoPackagesNoTax | 8 |
MetaExtended | 9 |
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:
- MetaExtended - as it is lightweight and returns all of the commonly needed fields. (Without Hotel data)
- 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 :
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)
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
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
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
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)
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
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
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)
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
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.
Updated 6 months ago