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

1

### Get Your API Key

Sign up for a free account to get your API key. No credit card required for testing.

[Get API Key →](/users/sign_up)

2

### 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" 

3

### Integrate & Build

Use the returned data to build powerful hospitality applications.

[View Full Documentation →](/docs/endpoints/meta-search)

## Available Endpoints

### Meta Search
GET

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

[View Documentation →](/docs/endpoints/meta-search)

### Hotel Reviews
GET

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

[View Documentation →](/docs/endpoints/booking/hotel-reviews)

### Hotel Details
GET

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

[View Documentation →](/docs/endpoints/booking/hotel-details)

### Hotel Search
GET

Search for available hotels in any destination with flexible date and guest configurations.

[View Documentation →](/docs/endpoints/booking/search)

## 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 →](/docs/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](/contact)[Book a Demo](/book-demo)

Request

```curl
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"
```

Response

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

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