Every Hosta property comes with a lightweight embed widget and a small public API: no account or API key needed for the basics. Not comfortable with code? Our team will set this up for you, free.
Paste this snippet where you want availability and booking to appear. It renders your property's live calendar and lets guests submit a booking request without leaving your site.
your-property-slug is the same slug your direct booking page uses.
<div data-hosta-property="your-property-slug"></div> <script src="https://hostahq.co/widget.js" async></script>
GET /api/public/availability ?slug=your-property-slug &start=2026-08-01 &end=2026-08-31
Returns approved bookings and manual blocks for the date range you ask for: no guest data included. CORS-enabled, so you can call it straight from a browser to build your own calendar view.
Availability is re-validated on our end before anything is saved, so two guests can never book the same dates. Every submission lands as pending, ready for you to confirm. This is the exact same endpoint our own on-site widget uses.
firstName, email, phone and the dates are required; lastName, chefRequested and specialRequests are optional. Rate limited to 10 requests per 5 minutes per IP.
// Request
{
"slug": "your-property-slug",
"firstName": "Maya",
"lastName": "Kessler",
"email": "maya@example.com",
"phone": "+254700000000",
"checkIn": "2026-08-12",
"checkOut": "2026-08-16",
"guests": 2
}
// Response 200
{ "success": true, "bookingCode": "HS-20260812-A1B2", "status": "pending" }
// 409 if the dates are taken · 429 if rate limitedhttps://hostahq.co/api/public/ics/ your-property-slug
A standard iCal feed of booked dates and blocks, with no guest details: paste this URL into Airbnb, Vrbo, Google Calendar, or any tool that accepts an iCal import.
If you run several properties, one call returns them all: name, location, cover image and nightly rate - keyed by your host (organization) slug. Perfect for building a multi-property picker before deep-linking into each property's booking flow by its slug.
GET /api/public/host/your-host-slug/properties
// Response 200
{
"host": { "name": "Mara View Collection" },
"properties": [
{ "slug": "mara-view-villa", "name": "Mara View Villa",
"location": "Maasai Mara", "currency": "KES",
"nightlyRate": 22000, "coverImageUrl": "…" }
]
}Send us your website and property slug, and our team will get the booking widget embedded and tested - free, as part of every Hosta plan.
Talk to our teamSimple, affordable booking and property management software for hosts, worldwide.