StayAPI Documentation
Welcome to the StayAPI documentation. Learn how to integrate real-time hospitality data into your applications with our powerful REST API.
Quick Start
Get Started in Minutes
Follow these simple steps to make your first API call and start accessing hospitality data.
Get Your API Key
Sign up for a free account to get your API key. No credit card required for testing.
Get API Key →Make Your First Request
Use our Meta Search endpoint to find booking links for any hotel across multiple platforms.
-H "x-api-key: YOUR_API_KEY" \
-G -d "hotel_name=Four Seasons Resort Bali"
Integrate & Build
Use the returned data to build powerful hospitality applications.
View Full Documentation →Available Endpoints
Meta Search
GETFind booking links for any hotel across multiple platforms including Booking.com, Expedia, Hotels.com, and more.
View Documentation →Hotel Reviews
GETAccess detailed customer reviews, ratings, and feedback from various booking platforms.
View Documentation →Hotel Details
GETGet comprehensive hotel information including amenities, location, contact details, and photos.
View Documentation →Hotel Search
GETSearch for available hotels in any destination with flexible date and guest configurations.
View Documentation →Authentication
API Key Required
All API requests require a valid API key passed in the x-api-key header.
StayAPI uses API keys for authentication. Include your API key in the x-api-key
header with every request.
Need Help?
Get Support
Can't find what you're looking for? Our team is here to help you integrate StayAPI successfully.
curl -X GET "https://api.stayapi.com/v1/meta/search" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -G \ -d "hotel_name=Four Seasons Resort Bali" \ -d "location=Jimbaran, Indonesia"
const response = await fetch("https://api.stayapi.com/v1/meta/search?" + new URLSearchParams({ hotel_name: "Four Seasons Resort Bali", location: "Jimbaran, Indonesia" }), { headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" } }); const data = await response.json(); console.log(`Found ${data.data.platform_count} booking platforms`); // Display available platforms Object.entries(data.data.links).forEach(([platform, url]) => { console.log(`${platform}: ${url}`); });
import requests url = "https://api.stayapi.com/v1/meta/search" headers = { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" } params = { "hotel_name": "Four Seasons Resort Bali", "location": "Jimbaran, Indonesia" } response = requests.get(url, headers=headers, params=params) data = response.json() if response.status_code == 200: print(f"Found {data[\"data\"][\"platform_count\"]} platforms:") for platform, url in data["data"]["links"].items(): print(f" {platform}: {url}") else: print(f"Error: {response.status_code}")
<?php $url = "https://api.stayapi.com/v1/meta/search"; $params = http_build_query([ "hotel_name" => "Four Seasons Resort Bali", "location" => "Jimbaran, Indonesia" ]); $headers = [ "x-api-key: YOUR_API_KEY", "Content-Type: application/json" ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url . "?" . $params); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $data = json_decode($response, true); curl_close($ch); if ($data["status"] === "success") { echo "Found " . $data["data"]["platform_count"] . " platforms:\n"; foreach ($data["data"]["links"] as $platform => $url) { echo "$platform: $url\n"; } } ?>
{ "status": "success", "data": { "hotel_name": "Four Seasons Resort Bali", "location": "Jimbaran, Indonesia", "links": { "booking_com": "https://www.booking.com/hotel/id/four-seasons-resort-bali-at-jimbaran-bay.html", "expedia": "https://www.expedia.com/Jimbaran-Hotels-Four-Seasons-Resort-Bali.h1234567.Hotel-Information", "hotels_com": "https://hotels.com/ho123456/four-seasons-resort-bali-jimbaran-indonesia/", "agoda": "https://www.agoda.com/four-seasons-resort-bali-at-jimbaran-bay/hotel/bali-id.html", "tripadvisor": "https://www.tripadvisor.com/Hotel_Review-g469404-d301386-Reviews-Four_Seasons_Resort_Bali_at_Jimbaran_Bay.html", "kayak": "https://www.kayak.com/hotels/Four-Seasons-Resort-Bali-c47329.h123456.Hotel-Information", "priceline": "https://www.priceline.com/hotel-deals/four-seasons-resort-bali-h123456", "official_website": "https://www.fourseasons.com/jimbaran/" }, "platform_count": 8, "official_website_detected": true, "search_quality": "high", "response_time_ms": 245 } }
{ "error": { "code": "not_found", "message": "No booking links found for the specified hotel", "details": "Try using a more specific hotel name or check the spelling" } }