Hotel Search V3

The Hotel Search web service returns hotel stay offers live from our travel partners. This service will help you bring travel to live on your site by providing your users with the opportunity to quickly find available hotel rooms in an exhaustive list of destinations all over the world.

Request Parameters

The Hotel Search web service supports the folowing request parameters:

Name Type Summary
city string (required) The name of the city.
hotel string (optional) The name of the hotel.
checkin_day integer (required)
1-31		 The check-in date.
checkin_month integer (required)
1-12		 The check-in month.
checkin_year integer (required) The check-in year.
nbnights integer (required) The number of nights in the Hotel.
num_adults integer (required)
1-5		 The number of adults.
num_children integer (required)
0-5		 The number of children.
roomtype string (required) The type of room. The value depends on the country.

  • For UK the value can be: Single, Twin, Double or Family.
  • For France the value can be: Simple, Jumelle, Double or Familliale.
rating integer (optional) The number of stars to search for.
sort string (optional) Sort the results by:

  • name_ascending
  • name_descending
  • merchantname
  • price_ascending
  • price_descending
  • rating_ascending
  • rating_descending
results integer (optional) The number of results to return in each request
start integer (optional) The start index of the first result to return.
searchId string (optional) The search ID identifying the search. This is needed for paging

Response Elements

Top level Elements

Name Summary
HotelSearch Contains Hotel elements.

Attributes:

  • totalResultsReturned: The number of results; returned.
  • firstResultPosition: The position of the first result in the overall search.
  • searchId: The unique identifier for this search that will be used for paging.

Offer elements

  • Common fields are used.
  • Only the offer type HOTEL_KELKOO can be contained in this service.

Sample Response

The following is a sample response when you search for a paris room with the service.

<Offer type="HOTEL_KELKOO" id="1028116506">
<Title>Corus Hyde Park</Title>
−
<Description>
Close to major attractions and city excitement, we invite you to be our guest&amp;amp;amp;#xA; Our accommodations and first class service are the staple of this prime location
</Description>
−
<Images>
−
<Image>
−
<Url>
http://image1.urlforimages.com/6939/01Front_Thumbnailed.jpg
</Url>
<Height>70</Height>
<Width>70</Width>
</Image>
</Images>
−
<Url>
http://uk.shoppingapis.kelkoo.com/ctl/go/shopbotGo?.ts=1254493965289&amp;amp;amp;.sig=6_sxm9R3.k.FgC.5fArMWb4qWaw-&amp;amp;amp;catId=170701&amp;amp;amp;searchId=217146178142_1254493952872_159050&amp;amp;amp;tsSearchId=null&amp;amp;amp;merchantId=9370223&amp;amp;amp;pkey=0&amp;amp;amp;affiliationId=96925221&amp;amp;amp;country=uk&amp;amp;amp;offerId=1028116506&amp;amp;amp;marrival=12&amp;amp;amp;yarrival=2009&amp;amp;amp;nbadults=1&amp;amp;amp;darrival=10&amp;amp;amp;nbnights=1&amp;amp;amp;rating=1&amp;amp;amp;nbchildren=0&amp;amp;amp;town=London&amp;amp;amp;from=shopbot&amp;amp;amp;wait=true&amp;amp;amp;ecs=ok
</Url>
−
<Merchant id="9370223">
<Name>Easy Click Travel</Name>
</Merchant>
−
<Category id="170701">
<Name>Hotels</Name>
</Category>
−
<Price currency="GBP">
<Price>77.01</Price>
</Price>
<NbAdults>1</NbAdults>
<NbChildren>0</NbChildren>
<NbBabies>0</NbBabies>
<Rating>4.0</Rating>
−
<Equipments>
Business Center;Concierge;Meeting/Banquet Facilities;Non Smoking Rooms;Restaurant(s);Room Service;Safe Deposit Box;Bar/Lounge;Laundry/Valet;24-Hour Front Desk;Gift/Sundry Shop;Currency Exchange;Interior Corridors;Dry Cleaning Service;Business Services;Elevator(s);Internet Access;
</Equipments>
<DepartureDate>2009-12-11+01:00</DepartureDate>
<ArrivalDate>2009-12-10+01:00</ArrivalDate>
<RoomType>Standard Single<!-- other --></RoomType>
<Duration>1</Duration>
<Address>1-7 Lancaster Gate London  W2 3LG</Address>
<Area>Bayswater-Paddington</Area>
<HotelChain/>
<Town>London</Town>
</Offer>

Related Web Services

Flight Search