Hotels.search | Previo API

Hotels.search

Hotel search

Always use the parameter "limit". If this parameter is not set, the function will return 100 results. The maximum number of returned results through a single request is 300. If you set a limit greater than 300, the function will return 100 results.  

Parameters

Name Description
login Username
password Password
filter

Result filter - available filter fields:

hotId,

name,

url,

region,

regionId,

county,

countyId,

couId,

town,

townId,

hoyId,

version,

h.hot_street,

t.tow_name,

z.zip_zip,

location,

address,

phone,

mail,

lctId,

licId,

collaboration

order Result order
limit Limit to the number of results
lanId Language ID, in which you would like descriptions to be returned (optional)
companyNumber Identification number (IČ/IČO) 
companyVATNumber Tax identification number (DIČ)

filter

Example: Hotels which are currently active

<filter>
    <in>
        <field>collaboration</field>
        <value>active</value>
    </in>
</filter>

filter by IČ/DIČ

Example: Hotels which have specific IČ and DIČ

<filter>
    <in>
        <field>companyNumber</field>
        <value>258444545</value>
    </in>
    <in>
        <field>companyVATNumber</field>
        <value>CZ25975234</value>
    </in>
</filter>

 

Sample request

<request>
    <login>prihlasovaci_jmeno</login>
    <password>heslo</password>
    <order>
        <by>name</by>
        <desc>false</desc>
    </order>
    <limit>
        <offset>100</offset>
        <limit>200</limit>
    </limit>
</request>

Sample request: Hotel search for a specified country (for a list of countries use the function getCountries)

<request>
    <login>prihlasovaci_jmeno</login>
    <password>heslo</password>
    <filter>
       <in>
           <field>couId</field>
           <value>648</value>
       </in>
    </filter>
    <limit>
        <offset>100</offset>
        <limit>200</limit>
    </limit>
    <lanId>2</lanId>
</request>

Output

<hotels> [1]  
 
<foundHotels> [1] Number of found hotels without limit
<hotel> [0..*] Detailed information about the hotel. Format of the output is identical to the function Hotel.get.

Sample output

<hotels>
    <foundHotels>2707</foundHotels>
    <hotel>
        <hotId>...</hotId>
        ...
    </hotel>
     ...
</hotels>