Help CentreIntegrations Website integrationHow does my web developer create an availability search form on my website?

How does my web developer create an availability search form on my website?

Your web developer can easily create a search form on your own website that links to the SuperControl availability search.

Doing this gives you complete control over the look and feel of the form and how it integrates into your website.

The HTML form should post data using the GET method to the following URL:Your web developer can easily create a search form on your own website that links to the SuperControl availability search.

https://secure.supercontrol.co.uk/availability/availability_search.asp

Compulsory hidden form fields:

ownerID Your ownerID
siteID
Your siteID

You can send additional parameters if you want the country/region/town fields to appear in the SuperControl search form.

To show regions and towns (click here for list of ISO country codes):

show_regions=1&iso=[default iso country code]&show_towns=1

To show countries regions and towns:

show_regions=1&show_towns=1

To show property types (if used on your account):

search_show_types=1

To show star grading:

show_stars=1

To show property name:

show_name=1

Form fields

You can send the following data in your request. If you send a startdate you must send either numbernights or enddate. 

Otherwise all fields are optional.

Example form code

A basic example can be downloaded from: https://secure.supercontrol.co.uk/downloads/example_search_form.htm

Relevant API requests

Clients using the SuperControl API can create dynamic country / region / town fields in their search.

Property types: http://secure.supercontrol.co.uk/xml/types_[your siteID].xml

Countries: https://secure.supercontrol.co.uk/xml/countries.asp?siteID=[your siteID]

Regions and towns: http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=[your siteID]

The above URL will request the top level regions and all towns.

The regions API can accept additional parameters:

country The two char ISO country code    
 regionID The regionID (used to filter towns)
level Default is zero. E.g. level=1 will show second level regions    
parentID Combine with level to drill down regions

For example to create a series of dynamic country / region / town drop downs:

Show all top level regions in GB http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=123&country=GB

Display a second field for sub regions http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=123&country=GB&parentID=456&level=1

Towns will be filtered appropriately as you drill down.

0 Comments

How can we make this page better for you?

E-Mail me when someone replies to this comment