Search Gateway: Hotel

The Hotel Search Gateway permits the initiation of a hotel search query on the Kayak website. When executed, the user's browser is directed to the Kayak website within which a query is performed as an anonymous user. The user can traverse result links and book hotels.

The base URL for this query is http://www.kayak.com/s/search/hotel. The table below shows the arguments which are to be GET'd.

External Variable Semantics Range Default Example
ai Affiliate identifier provided by Kayak.com. Character string. No embedded whitespace or special characters. Empty string.
p Optional Sub-Affiliate identifier. This is a pass-thru value from Kayak's perspective; used by affiliate for internal promotion tracking if desired. Character string. No embedded whitespace or special characters. Empty string.
do Answers the question: "Should we do the search as opposed to just pre-populating the search form?". y,n,on,off y
pa Number of Guests 1,2,3,4 1
rm Number of Rooms 1,2 1
df Date format for dates in this request. us1, mdy, dmy, ymd us1
d1 Check-in Date. Format specified by field df.  
d2 Check-out Date. Format specified by field df.  
crc City, Region, Country combined in single string separated by commas. We assume a comma separated list of City, State, Country.  
hid Hotel identifier. Character string. Digits only. No embedded whitespace or special characters. You would find hotel identifier by visiting the "hotel details" page for a particular hotel and seeing the 5 digit id in the URL.  
s Minimum star rating. 1 through 5. -1 means any  
lmaddr Landmark Address. Used in conjunction with lmname. Kayak will try to determine geo-location of the given address and, if successful, will add that point as the default landmark on the hotel results page. Address.  
lmname Landmark Name. Used in conjunction with lmaddr. This is the label to be associated with lmaddr on the resulting map. By default sets map=y. Text to be used as label on map.  
lmzoom Landmark Zoom. Used in conjunction with lmaddr. This is the initial google zoom value to be associated with lmaddr on the resulting map. 1-17  
lmdist Indicates a maximum distance from which results can be relative to the given landmark. 0.25, 0.5, 1, 2, 5, 10, 15, 20, 25, 50  
map Indicates whether the big map should be displayed on the results page on initial load. 'y' will always display the map, 'n' will never display it. The default is d, which will follow the default behavior of the map display. y,n,d d
 

About  |  Advertise  |  Privacy  |  Destinations  |  Feedback  |  iPhone  |  Android  |  BlackBerry  |