home > support > API > Marketplace API > hotel search > by specific date
| Purpose | Create a hotel/chalet/villa search results page based on availability for specific dates | |
|---|---|---|
| Notes | Extends the standard Tour Search Method to allow searching for hotels available to be booked for a specific date for a specific duration (and optionally a specific number of people). Includes a list of rooms alongside each Hotel. | |
| REST info | Call | /p/hotels/search_avail /c/hotels/search_avail |
| Formats | XML | |
| Example | /p/hotels/search_avail.xml?startdate_yyyymmdd=2011-07-16&hdur=7 | |
| Verb | GET | |
| Code |
PHP examples use the PHP Client Library with SimpleXML Description
Parameters
Example
C# examples use the .Net Client Library Overload list
Parameters
Example
VB examples use the .Net Client Library Overload list
Parameters
Example
| |
Supports all of the querystring parameters (apart from paging) from the Tour Search Method plus:
| Parameter | Notes |
|---|---|
| startdate_yyyymmdd | (YYYY-MM-DD) - Start (check in) date |
| hdur | Duration (days / nights) |
| ad | Adults (non mandatory) |
| ch | Children (non mandatory) |
| single_tour_id | This will just check that product. Useful if you have a single product page and want to show some live price data. Bear in mind that the tour id is unique per TourCMS account so if you are using this API in a mutli account environment you could get a couple of products back in the XML. (non mandatory) |
Returns the same data as the standard Tour Search Method plus each tour node has a new availability node which contains the following data:
| XML Node | Notes | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| room_rate |
There will be one room_rate node for each Room or Rate that is available for that tour. Each room_rate node contains the following child nodes.
|
You can append the following to the book link (returned in the XML):
No fields are mandatory. Further informtion about linking to the booking engine with default values
© 2003-2012 Travel UCD Limited. All rights reserved. TourCMS® is a registered trademark of Travel UCD Limited, United Kingdom. View Privacy policy.