Overview
Using Bookster's API you can build a custom user journey through your website for your guests.
Use our API to:
- Render pre-built components
- Poll live availability
- Poll / export bookings
- Poll / export listing data
See our full list of functions
Accessing our API
To get started - Register to create a Bookster account. Once you've created an account, go the your user settings and tick the 'Developer' setting to enable the API.
Once the 'Developer' setting is enabled - our API docs are also available when logged into Bookster under the API section.
Book now button
Place "Book now" button or link onto a web page.
Bookster -> [Property name] -> Actions -> Get HTML
Calendar widget
Place an availability and booking calendar on a property page.
Bookster -> [Property name] -> Actions -> Get HTML
Branding
Add your own look and feel to the checkout process.
The colours and header image can be set to match your own branding:
Bookster -> Bookster subscription -> "Edit"
WordPress plugin
Instant Booking from a WordPress website
Add an availability search form to your WordPress website.
The form starts the guest journey across to the Bookster Search Engine.
Check out the plugin on wordpress.org.
Check out the plugin on wordpress.org.
iCal
Publish availability via iCal
Use iCal to share availability of a property.
Bookster -> [Property name] -> Availability
Example: https://secure.booksterhq.com/book/ical/115680.ics
.
Use this URL to programatically read the availability of any Bookster holiday rental property.
Read availability via iCal
Pull availability into Bookster using iCal calendar format.
Bookster -> [Property name] -> Availability
Each Bookster property can read an iCalendar (.ics) formatted file. Add a property specific iCalendar URL under the "availability" page for each Property.
Bookster will check the iCalendar (ics) URL:
- periodically; and
- before accepting a booking.
Bookings
Poll and export booking data.
Export with iCal
Bookster -> Bookings -> Actions -> Calendar feed…
The iCalendar feed contains Check IN and Check OUT events for the next 30 days.
Each event can contain the following booking information:
- Name
- Phone
- Party size
- Total
- Outstanding balance
- Damage deposit
Export with JSON
Use a RESTful API to pull out bookings in JSON format.
Authenticating with an API key
You can use an API key and HTTP Basic Authentication to authenticate API requests. You can get your API key from the Account page when logged into the Bookster.
Bookster -> More -> API
Export for Excel
Download bookings to an Excel compatible spreadsheet format.
Bookster -> Bookings -> Actions -> Export to Excel
Properties
Use property data directly from a Bookster Website in JSON form to build / update listings dynamically.
List & search find.json
Use find.json
to:
- export all properties
- filter on facilities or availability searches
Example: http://demo.booksterhq.com/find.json
Note: you must first set up a Bookster Website to export property data via JSON.
{ "meta": { "type": "property", "total_count": 3 }, "data": [ { "id": 115680, "created_on": "2015-11-09", "updated_on": "2016-07-12", "name": "House by the river", "price": { "currency": "GBP", "cost": 140, "saving": 0 } }, { "id": 115653, "created_on": "2015-11-03", "updated_on": "2015-11-10", "name": "House in the valley", "price": { "currency": "GBP", "cost": 350, "saving": 0 } }, { "id": 115616, "created_on": "2015-10-27", "updated_on": "2016-07-06", "name": "House on the hill", "price": { "currency": "GBP", "cost": 864, "saving": 0 } } ] }
Use the same GET args used on Bookster websites searching e.g.
- Facilities:
facilities/102-wifi
- Properties with Wifi
- Availability:
availability/2017-05-06-until-2017-05-13-for-2
- Properties available to book arriving 2017-05-06, departing 2017-05-13 for 2 people
- Location:
geoloc/within-50-miles-of-56.041918,-2.820786
- Properties within X miles of a lat / lon
Single property details view.json
Example: http://demo.booksterhq.com/view.json/115680-house-by-the-river
{ "id": 115680, "name": "House by the river", "importRef": "", "created": 1447082911, "updated": 1468329782, "elements": { "address": { "street": "123 Riverside Road", "town": "Rivertown", "county": "Lothian", "region": "Scotland", "postcode": "EH1 2BB", "country": "United Kingdom" }, "num_bedrooms": "4", "catering_options": [ "self catered" ], "check_in_ends": "17:00", "check_in_starts": "13:00", "check_out_time": "10:00", "description": "A lovely holiday rental by the river!", "directions": "Turn left off the main road when arriving from town, you'll see the Kirk after going under the bridge and the house is on the right hand side.", "exterior_description": "An 18th century stone cottage with a beautiful drive.", "facilities": { "dishwasher": true, "tumble_drier": true, "fridge_freezer": true, "oven": true, "linen_provided": true, "hair_dryer": true, "hi_chair": true, "satellite_cable": true, "television": true, "wireless_internet": true, "balcony": true }, "geoloc": [ 55.895952, -3.307909 ], "greatfor": { "countryside": true, "family": true, "secluded": true, "romantic": true }, "tourist_attractions": "The area nearby is a vibrant place full of wildlife and great natural features. Just up the (insanely steep - be warned if you are cycling) hill, there are the foothills of the Pentlands which surround Rivertown, including some lovely (flatish) walks that suit all abilities (assuming you can get up the initial hill - but you can just take the car!)", "recreation": { "boat_launch": true, "cycle_hire": true, "fishing": true, "golf": true, "horse_riding": true, "winter_sports": true, "shops": true, "bars": true, "restaurants": true, "health_spa": true, "boat_hire": true, "boat_mooring": true, "car_hire": true, "cycle_paths": true, "parking": true, "playground": true }, "parking_details": "There is ample parking for up to six cars.", "gallery": [ { "title": "Sunset", "description": "", "copyright": "", "source": "http:\/\/cdn.tribalogic.net\/uploads\/d4\/402106.jpg", "width": 3752, "height": 2627, "size": 1801821 }, { "title": "The river", "description": "", "copyright": "", "source": "http:\/\/cdn.tribalogic.net\/uploads\/35\/402102.jpg", "width": 4341, "height": 3036, "size": 2602573 }, { "title": "A lovely view of the river", "description": "\"The River Cam from the Green Dragon Bridge\" by FinlayCox143 - Own work. Licensed under CC BY-SA 3.0 via Commons - https:\/\/commons.wikimedia.org\/wiki\/File:The_River_Cam_from_the_Green_Dragon_Bridge.jpg#\/media\/File:The_River_Cam_from_the_Green_Dragon_Bridge.jpg", "copyright": "Licensed under CC BY-SA 3.0 via Commons", "source": "http:\/\/cdn.tribalogic.net\/uploads\/8a\/402121.jpg", "width": 3999, "height": 2799, "size": 2428949 }, { "title": "The river on St Patrick's Day", "description": "\"Loboc river\" by Qaalvin - Own work. Licensed under CC BY-SA 3.0 via Commons - https:\/\/commons.wikimedia.org\/wiki\/File:Loboc_river.png#\/media\/File:Loboc_river.png", "copyright": "Licensed under CC BY-SA 3.0 via Commons", "source": "http:\/\/cdn.tribalogic.net\/uploads\/03\/402125.jpg", "width": 766, "height": 536, "size": 171607 } ], "price_range_grain": "nightly", "location": [ [ "Europe", "UK & Eire", "Scotland", "Lothian" ] ], "sleeping_arrangements": "Four double bedrooms\r\nTwo sofa beds can be set up if required", "sleeps_additional": 4, "sleeps_basic": 8 } }