The Holidu API Guide - Integration Steps

Here are the typical steps you will need to go through to be live on Holidu through our API. Your overall aim is to map your data to our API’s data structure so that we can display the correct information regarding your properties to the customers.



1. Discover our API and its endpoints through our test API

Access our API : https://provider-api.holidu.com/docs/index.html#/

You may discover all endpoints (apartments, rates, availabilities, etc.) and their fields.

For each endpoint, there is an example and a model. The model describes each fields and their expected values.

2. Log responded errors and fix them

We send a response for each request you send to the API. Please log the errors and fix them.

This stage will end once you don’t get any error anymore when pushing data.

3. Push data to the live API

Once you don’t get error anymore, please inform us by email. We will give you access to the live API.

You now need to switch to the live API and push real properties there. To do so: use the live API URL instead of the test API URL.

We will also provide you credentials for our partner portal where you can test your properties yourself before they will go in the final testing phase on our side.



Important

When pushing data, please make sure to : 

  • push "real" apartment data. Avoid pushing empty or null (0) values, as this will block our indexation processes and will prevent the property from getting live, and thus, testable. 

  • push availability and book date



4. Schedule a regular and automatic push of data

Schedule a process to push data regularly to all endpoints of the API. Especially the availabilities should be pushed at least once a day. If you don't update the availabilities of an apartment within 10 days, it will be removed automatically from holidu.

5. (Only for Onsite booking) Implement availability and booking endpoint

If you want to be onsite booking on Holidu, you have to implement the booking and availability endpoints. You can find more information here.

6. Self Certification

Once we get all your data through the live API, you can test your apartments in a closed environment. Once everything is correct, you can send us the certification and we will do a quick additional test.

7. Go live on one domain (soft release)

Once we get and display correct and consistent data from you, we are ready to put you live one domain on holidu to test your data in a real live environment.

8. Go live on all domains

Congrats, you made it! You can always check your inventory and performance in the holidu partner portal and are encouraged to do so.





In case you have any questions, please contact providersupport@holidu.com