To help you with the development of the VacaVilla XML API we have compiled this list of F.A.Q. , if you have further questions please contact us at developers(at)vacavilla.com
We are glad you want to work with us, the first thing you have to do is to get in touch with our agency department writing an email to: agency(at)vacavilla.com then you will be able to discuss your sales commission and sign the collaboration contract.
In the meanwhile you can have a look to the technical side of the VacaVilla XML API reading the specific documentation. The XML API allows you to import our data in your website, or make queries in realtime and display the results to your users.
Our XML solution is a very simple but complete system that allows you to add our selection of vacation villas to your website, it is designed as a webservice that you can query using standard http calls, each query has its own distinct reply in XML format.
Using the XML API you can build a complete website around our offer starting from the list of regions, zones and towns where our villas are located, to the full data of each of our vacation homes.
If you want to know in detail how each query works simply read the specific documentation
If you want to add all of your houses to your website we have a special query in place build with this purpose:
Using the HTTP request above you will receive a long list in XML format with the full data of every one of our vacation villas, it's a lot of data and quite a long query to process so give it the time to finish and when your solution is ready don't use it more than once a day.
To know the details of the request and each single data in the XML reply please refr to the full XML API documentation
Our XML API provide a direct call to fetch the calendar for every one of our villas, you can read the calendar for a specific villa or request them in bulk and store them somewhere in your database.
To read the availability for a single villa use something like this:
the HTTP query above returns the availability calendar for the house VV30230, if you want to retrieve all the availability data use something like this:
the HTTP query above will return the availability for all of our villas.
If you want to know in detail how this queries work please refer to the full XML API documentation
Unfortunately at the moment we don't have any query that allows you to book a house straight on our system, so once you have completed our data integration to send us bookings you can choose any of these three methods:
Of course you can, we provide you all of our data, but you are free to filter out the villas you are not interested in, to make this job easier for you we have developed our "searchhouses" query that it's our search engine in XML format, have a look to the XML api documentation to find out how you can use the "searchhouses" query to filter our database.
If you want you can also pick the houses one by one writing down their house ID and use the "viewhouse" query to retrieve the data for each of your chosen villas.
You have two different ways to find out the property ID (that you must use if you want to retrieve the data for a single property) :