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.travelsearch.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.  
b Brand identifier used to preset the search-results filter so that only this brand is initially shown in the results. Brand identifier. (see table below for list of brand symbol values)  
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. 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  
 

Hotel Brand Symbols

BrandBrand Code
Accor Hotelsallaccor
AmeriHost Inns & Suitesamerihostinn
AmeriSuitesamerisuites
ANA Hotels Intlana
Baymont Inns & Suitesbaymontinnss
Best Value Innsbestvalueinn
Best Western Intl Incbestwesterni
Candlewood Hotel Company, Inc.candlewoodho
Cendant Corporationallcendant
Choice Hotelsallchoice
Clarion Hotels & Resortsclarion
Club Medclubmed
Comfort Inns & Suitescomfortinns
Conrad Hotelsconrad
Country Inns & Suites By Carlsoncountryinnss
Courtyard by Marriottcourtyardbym
Crestwood Suitescrestwoodsui
Crowne Plaza Hotels & Resortscrowneplaza
Days Inns of America, Inc.daysinnsofam
Delta Hotelsdelta
Doubletree Hotels-Suites-Resorts-Clubsdoubletree-c
Econo Lodges of America Inceconolodgeso
Embassy Suites Hotelsembassysuite
Extended Stay Americaallextended
Fairfield Inn & Suites by Marriottfairfieldinn
Fairmont Hotels & Resortsfairmont
Fiesta Americana & Fiesta Inn Hotelsfiestaameric
Four Points Hotels by Sheratonfourpointsby
Four Seasons Hotelsfourseasons
Golden Tulip Worldwidegoldentulip
Hampton Inns & Suiteshamptoninnss
Hawthorn Suiteshawthornsuit
Hilton Garden Innhiltongarden
Hilton Hotelsallhilton
Holiday Inn Express Hotelsholidayinnex
Holiday Inn Garden Court Hotelsholidayinnga
Holiday Inn Hotels & Resortsholidayinn
Holiday Inn Select Hotelsholidayinnse
Holiday Inn SunSpree Resortsholidayinnsu
Homewood Suites by Hiltonhomewoodsuit
Howard Johnsonhowardjohnso
Hyatt Hotelsallhyatt
Hyatt Placehyattplace
Hyatt Summerfield Suitessummerfields
Ibis Hotelsibis
InterContinentalallintercon
JW Marriott Hotels & Resortsjwmarriott
Kimptonkimpton
 
BrandBrand Code
Knights Innknightsinn
La Quinta Corporationlaquinta
Le Meridien Hotels & Resortslemeridien
Loews Hotelsloews
MainStay Suitesmainstaysuit
Mandarin Oriental Hotel Groupmandarinorie
Marriott Conference Centersmarriottconf
Marriott Executive Apartmentsmarriottexec
Marriottallmarriott
Mercure Intl Hotelsmercure
Microtel Inns & Suitesmicrotelinns
Morgans Hotel Groupmorgans
Motel 6motel6
NH Hotelesnhhoteles
Novotelnovotel
OHANA Hotels & Resortsohana
Omni Hotelsomni
Peninsula Hotelspeninsula
Quality Inns, Hotels & Suitesqualityinns
Radisson Hospitality Worldwideradissonhosp
Raffles Intl Hotels & Resortsraffles
Ramada Intl Hotels & Resortsramada
Red Lion Hotels & Innsredlioninns
Red Roof Inns, Inc.redroofinns
Renaissance Hotels & Resortsrenaissance
Residence Inn by Marriottresidenceinn
Rodeway Inns Intlrodewayinns
Scandic Hotelsscandic
Shangri-La Hotels & Resortsshangri-la
Sheraton Hotels & Resortssheraton
Sleep Innssleepinns
Sofitel Accor Hotels & Resortssofitelaccor
Sol Meliasolmeliahote
SpringHill Suites by Marriottspringhillsu
Starwoodallstarwood
Staybridge Suites by Holiday Innstaybridgesu
St Regis Hotels & Resortsstregis
Studio 6studio6
Super 8 Motels Incsuper8motels
The Ritz-Carlton Hotelsritz-carlton
Thistle Hotels Limitedthistlelimit
TownePlace Suites by Marriotttowneplacesu
Travelodgetravelodge
Walt Disney Parks & Resortswaltdisneypa
Westin Hotels & Resortswestin
W Hotelsw
Wingate Innswingateinns
Wyndhamallwyndham