StayAPI Documentation

Welcome to the StayAPI documentation. Learn how to integrate real-time hospitality data into your applications with our powerful REST API.

Copy for your AI agent

Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.

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

Get API Key →

Make Your First Request

Use our Meta Search endpoint to find booking links for any hotel across multiple platforms.

curl -X GET "https://api.stayapi.com/v1/meta/search" \
-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

GET

Find booking links for any hotel across multiple platforms including Booking.com, Expedia, Hotels.com, and more.

View Documentation →

Hotel Reviews

GET

Access detailed customer reviews, ratings, and feedback from various booking platforms.

View Documentation →

Hotel Details

GET

Get comprehensive hotel information including amenities, location, contact details, and photos.

View Documentation →

Hotel Search

GET

Search 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.

Learn More About Authentication →

Need Help?

Get Support

Can't find what you're looking for? Our team is here to help you integrate StayAPI successfully.

Contact Support Book a Demo

Request

curl -X GET "https://api.stayapi.com/v1/meta/search?hotel_name=Four%20Seasons%20Resort%20Bali&location=Jimbaran%2C%20Indonesia" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

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";
    }
}
?>

Response

{
  "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"
  }
}