Skip to main content

Hotel Search

2.0.0
Hotel
Search
SOAP API
Travel Agency

The Hotel Search (HotelSearchRQ) is used to retrieve a list of hotel properties, along with details of the property, according to the search criteria entered.

Not Signed In.

Looks like you may not have access to all of the resources and documentation for this page.
Please log-in or contact your support desk team if you believe you should have access.

Target Audience
Travel Agency
API Version
2.0.0
Authentication
Session or Sessionless Tokens
Service Action Code
HotelSearchRQ

What is it?

The Hotel Search API provides multiple location resolution methods (including polygon search) to search and retrieve matching property content that does not contain availability.

Why use it?

Retrieve an orchestrated list of properties with images and static content (such as amenities offered and location information) without the need to provide a specific stay period for availability. Hotel Search utilizes multiple advanced search filter options based on property/image content and enables customization of the search response. It can return up to 300 hotels, sorted using one of two criteria: Distance and Sabre Rating.

How does it work?

  1. Hotels falling within a given search location are retrieved using the Geo Search API.
  2. Apply a filter, such as Sabre Rating, in the call to narrow your search.
  3. Static information and a default image are then fetched for the filtered list of hotels.

This orchestrated API can be used in multiple ways and includes multiple search parameters and filters. 

How do I use it?

You can search for hotels in a general location using any of the following location formats: ​​​​

  • Latitude and longitude
  • Address of the location
  • Airport/city codes
  • Nearest point(s) of interest
  • Polygon IDs

Decide on filtering criteria: 

  1. Decide on the filtering criteria you'd like to use, if you wish to apply any filters to the response at all. Refer to the request documentation below for a full list of filtering criteria.
  2. With all required parameters complete, make a call to HotelSearchRQ.

Request structure

Refer to the Request Design Documentation for an XML view of the request structure.

Response structure

Refer to the Response Design Documentation for an XML view of the response structure.

 

Sample Request
<HotelSearchRQ
   xmlns="http://services.sabre.com/hotel/hsearch/v2"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0.0" xsi:schemaLocation="http://services.sabre.com/hotel/hsearch/v2 HotelSearchRQ_v2.xsd">
    <POS>
        <Source PseudoCityCode="TM51"/>
    </POS>
    <SearchCriteria MaxResults="200" SortBy="DistanceFrom" SortOrder="DESC" TierLabels="true">
        <GeoSearch>
            <GeoRef Radius="200" UOM="MI">
                <GeoCode Latitude="32.77" Longitude="96.79"/>
            </GeoRef>
            <GeoAttributes>
                <Attributes Name="LOCALAREA" Value="KRAKOW AREA"/>
            </GeoAttributes>
        </GeoSearch>
        <HotelPref>
            <PropertyQualityCodes Inclusive="false">
                <PropertyQualityCode>5</PropertyQualityCode>
                <PropertyQualityCode>2001</PropertyQualityCode>
            </PropertyQualityCodes>
            <SabreRating Min="1.0" Max="5.0"/>
        </HotelPref>
        <ImageRef Type="ORIGINAL" CategoryCode="2" LanguageCode="EN"/>
    </SearchCriteria>
</HotelSearchRQ>
Sample Response
<HotelSearchRS>
    <HotelSearchInfos MaxSearchResults="3" SearchLongitude="96.79" SearchLatitude="32.77">
        <HotelSearchInfo>
            <HotelInfo HotelCode="100126642" SabreRating="3.0" BrandCode="10010" Direction="E" Logo="http://vcmp-hotels.cert.sabre.com/image/upload/f_auto,q_auto:best,t_vcmp_logo/hotel/l/wv/WV.png" BrandName="TravelCLICK" UOM="MI" ChainName="TravelCLICK" ChainCode="WV" CodeContext="GLOBAL" Ordinal="1" SabreHotelCode="67980" HotelName="Gyalthang Dzong Hotel" Distance="186.92">
                <LocationInfo Latitude="33" Longitude="100">
                    <Address>
                        <AddressLine1>Zhongdian Shangri La</AddressLine1>
                        <CityName CityCode="SHA">Diqing Tobetan</CityName>
                        <PostalCode>674400</PostalCode>
                        <CountryName Code="CN">China</CountryName>
                    </Address>
                    <Contact Phone="86-887-822-7610" Fax="86-887-822-7610"/>
                </LocationInfo>
                <Amenities>
                    <Amenity Description="Family Room" Code="2014"/>
                    <Amenity Description="Rollaway adult" Code="2016"/>
                    <Amenity Description="Extra person" Code="2018"/>
                    <Amenity Description="Conference facilities" Code="24"/>
                    <Amenity Description="Airport shuttle service" Code="282"/>
                    <Amenity Description="Free parking" Code="42">Y FREE</Amenity>
                    <Amenity Description="Game room" Code="44"/>
                </Amenities>
                <SecurityFeatures>
                    <SecurityFeature Description="Complies with Local/State/Federal fire laws" Code="9"/>
                </SecurityFeatures>
                <PropertyQualityInfo>
                    <PropertyQuality Description="First Class" Code="2001"/>
                </PropertyQualityInfo>
            </HotelInfo>
        </HotelSearchInfo>
        <HotelSearchInfo>
            <HotelInfo HotelCode="100128540" SabreRating="3.0" BrandCode="10003" Direction="E" Logo="http://vcmp-hotels.cert.sabre.com/image/upload/f_auto,q_auto:best,t_vcmp_logo/hotel/l/oz/OZ.png" BrandName="Super 8" UOM="MI" ChainName="Super 8" ChainCode="OZ" CodeContext="GLOBAL" Ordinal="2" SabreHotelCode="69187" HotelName="Yibin Lu Neng Super 8 Hotel" Distance="186.92">
                <LocationInfo Latitude="33" Longitude="100">
                    <Address>
                        <AddressLine1>Bi Feng Garden Community</AddressLine1>
                        <CityName CityCode="YBP">Yi Bin Sichaun P.R</CityName>
                        <CountryName Code="CN">China</CountryName>
                    </Address>
                    <Contact Phone="86-831-8183333" Fax="86-831-2161999"/>
                </LocationInfo>
                <Amenities>
                    <Amenity Description="Car rental desk" Code="15">N</Amenity>
                    <Amenity Description="Non-smoking rooms (generic)" Code="198"/>
                    <Amenity Description="Stay Safe" Code="2002"/>
                    <Amenity Description="Local Calls" Code="2004"/>
                    <Amenity Description="Rollaway adult" Code="2016"/>
                    <Amenity Description="Crib charge" Code="2017"/>
                    <Amenity Description="Extra person" Code="2018"/>
                    <Amenity Description="Business center" Code="228"/>
                    <Amenity Description="Data port" Code="255"/>
                    <Amenity Description="High speed internet access" Code="259"/>
                    <Amenity Description="Children programs" Code="289"/>
                    <Amenity Description="Free parking" Code="42">Y-GARAGE</Amenity>
                    <Amenity Description="Hot Tub" Code="55"/>
                    <Amenity Description="Outdoor pool" Code="66"/>
                    <Amenity Description="Pool" Code="71"/>
                    <Amenity Description="Dry cleaning" Code="96"/>
                </Amenities>
                <SecurityFeatures>
                    <SecurityFeature Description="Complies with Local/State/Federal fire laws" Code="9">Y</SecurityFeature>
                </SecurityFeatures>
                <PropertyQualityInfo>
                    <PropertyQuality Description="Regular" Code="5"/>
                </PropertyQualityInfo>
            </HotelInfo>
        </HotelSearchInfo>
        <HotelSearchInfo>
            <HotelInfo HotelCode="100132448" SabreRating="3.0" BrandCode="10634" Direction="E" Logo="http://vcmp-hotels.cert.sabre.com/image/upload/f_auto,q_auto:best,t_vcmp_logo/hotel/l/yx/YX.png" BrandName="SynXis" UOM="MI" ChainName="SynXis" ChainCode="YX" CodeContext="GLOBAL" Ordinal="3" SabreHotelCode="71585" HotelName="Central Boutique Angkor Hotel" Distance="186.92">
                <LocationInfo Latitude="33" Longitude="100">
                    <Address>
                        <AddressLine1>Tapoul Road</AddressLine1>
                        <CityName CityCode="REP">Siem Reap</CityName>
                        <CountryName Code="HK">Hong Kong</CountryName>
                    </Address>
                    <Contact Phone="855-63-764030" Fax="855-63-764030"/>
                </LocationInfo>
                <Amenities>
                    <Amenity Description="Car rental desk" Code="15">Y-COMPLIMENTARY</Amenity>
                    <Amenity Description="Meal plan available" Code="162">Y</Amenity>
                    <Amenity Description="Non-smoking rooms (generic)" Code="198"/>
                    <Amenity Description="Stay Safe" Code="2002"/>
                    <Amenity Description="Family Room" Code="2014">Y</Amenity>
                    <Amenity Description="Complimentary breakfast" Code="227" ComplimentaryInd="true"/>
                    <Amenity Description="Business center" Code="228"/>
                    <Amenity Description="Golf" Code="236"/>
                    <Amenity Description="High speed internet access" Code="259">Y-ON SITE</Amenity>
                    <Amenity Description="Airport shuttle service" Code="282">Y</Amenity>
                    <Amenity Description="Free parking" Code="42">Y-ON SITE</Amenity>
                    <Amenity Description="Game room" Code="44"/>
                    <Amenity Description="Hot Tub" Code="55"/>
                    <Amenity Description="Outdoor pool" Code="66"/>
                    <Amenity Description="Pool" Code="71"/>
                    <Amenity Description="Dry cleaning" Code="96"/>
                </Amenities>
                <SecurityFeatures>
                    <SecurityFeature Description="Complies with Local/State/Federal fire laws" Code="9">Y</SecurityFeature>
                </SecurityFeatures>
                <PropertyTypeInfo>
                    <PropertyType Description="Resort" Code="30"/>
                </PropertyTypeInfo>
                <PropertyQualityInfo>
                    <PropertyQuality Description="Regular" Code="5"/>
                </PropertyQualityInfo>
            </HotelInfo>
        </HotelSearchInfo>
    </HotelSearchInfos>
</HotelSearchRS>