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 DetailLevels: 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.

Details Levels Comparison

Detail LevelUse-CaseDataPerformance
0 - DefaultBest for detailed analysis of a single hotel where full data is required.Complete hotel information, detailed package data, and comprehensive price breakdown.High due to large volume of data, potentially increasing response time and bandwidth usage.
1 - LowSuitable for applications needing basic hotel information without the overhead of extensive data.Basic hotel details including address, star rating, and simple price including tax.Does not include detailed room content, limiting its use in scenarios requiring room specifications.
2 - MinimalUseful when supplier anonymity is preferred or irrelevant to the user's decision-making process.Similar to Low but omits the supplier name from the package data.Slightly lighter than Low, as less data is transmitted.
3 - NoPackagesIdeal for scenarios where only hotel metadata is needed, such as in mapping or listing services.Only hotel-specific data like location and rating; does not include package or price details.Minimal data results in fast response times.
4 - MetaBest for comparison shopping where only the lowest price per supplier is necessary.Essential hotel details with the lowest package price per supplier included.Moderate; optimized for quick comparisons without deep dive data.
5 - LowNoTaxUseful in regions where tax is not a primary concern or for businesses that need to display tax-exclusive pricing.Similar to Low, but prices are displayed without tax considerations.Similar to Low, lacking detailed room content.
6 - MetaAdvancedUseful for enriched displays where additional hotel information enhances user decision-making.A more detailed set of hotel data including supplier names, trusted reviews, and comprehensive price information.Heavier than Meta but provides a richer dataset for end-users.
7 - MetaNoTaxAligns with Meta in use but specific to markets or scenarios where tax-excluded prices are required.Similar to Meta but displays the lowest package price from each supplier excluding tax.
8 - NoPackagesNoTaxOptimal for quick loading of hotel listings where pricing details are secondary.Minimal hotel data without package or tax information.Very light, ensuring fast responses.
9 - MetaExtendedComprehensive enough for full-feature booking sites that require detailed information to facilitate booking decisions.Extensive hotel and room data, including the cheapest rates with tax considerations and room availability.Most extensive, suitable for detailed searches but may impact performance.


Detail Levels - Breakdown :

0️⃣

Default (0) -

Includes more detailed price breakdown, more package information, and full 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
    • SupplierId
    • SupplierName

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
  • 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
    • Refundability
    • 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
  • CityTax
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocation (Long + Lat)
  • HighestPackagePrice
  • HotelID
  • LowestPackagePrice
  • StarRating

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
  • 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)
  • HotelID
  • PackageID
    • Refundability
  • Rooms
    • AdultsCount
    • Availability
    • RoomBasis
    • RoomClass
    • RoomType
  • SRSP
  • SimplePrice
  • Supplier short name
  • StarRating

6️⃣

MetaAdvanced (6) -

Returns the recommended required hotel data.

Breakdown of tags received:

  • Address
  • DefaultImage (FullSize)
  • DisplayName
  • GeoLocations (Long + Lat)
  • HotelID
  • 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)
  • 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 (*)
  • HotelID
  • LowestPackagePrice
  • StarRating

9️⃣

MetaExtended (9) -

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

Breakdown of tags received:

  • AvailableBoards (*)
  • 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

⭐

NOTE:

In order to get the starred (*) parameters : Suppliers need to support room information at the search step.
For suppliers who return room information in a separate call, the filtering option will not be available because this information is missing from the search step.