GET

Hotel Meta Search API

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

Overview

Primary Use Case

Perfect for travel comparison sites, hotel booking aggregators, and applications that need to provide users with multiple booking options.

The Meta Search endpoint searches across multiple booking platforms to find direct links for a specific hotel. This allows your users to compare prices and book through their preferred platform.

Endpoint URL

GET https://api.stayapi.com/v1/meta/search

Parameters

Parameter Type Required Description
hotel_name string Required The name of the hotel to search for. Be as specific as possible for better results.
location string Optional The location of the hotel (city, region, country). Helps improve search accuracy.
platforms array Optional Specific platforms to search. If not provided, searches all available platforms.
include_official boolean Optional Whether to include the hotel's official website in results. Default: true

Pro Tip

Include both hotel_name and location for the most accurate results. The more specific you are, the better the platform matching will be.

Response Format

Success Response (200 OK)

Field Type Description
status string Response status (always "success" for 200 responses)
data.hotel_name string The hotel name used for the search
data.location string The location used for the search
data.links object Object containing booking platform URLs
data.platform_count integer Number of platforms where the hotel was found
data.official_website_detected boolean Whether the hotel's official website was found

Available Platforms

The links object may contain URLs for the following platforms:

  • booking_com
  • expedia
  • hotels_com
  • agoda
  • tripadvisor
  • kayak
  • priceline
  • official_website

Common Use Cases

Travel Comparison Sites

Show users multiple booking options for the same hotel, allowing them to compare prices and choose their preferred platform.

Perfect for price comparison features

Affiliate Marketing

Generate affiliate revenue by providing users with direct booking links to partner platforms.

Maximize conversion opportunities

Hotel Discovery Apps

Help users find and book hotels across multiple platforms from a single interface.

Streamline the booking process

Travel Blogs & Content

Add booking options to hotel reviews and travel guides to monetize content.

Turn content into revenue

Error Responses

400 Bad Request

Missing required parameters or invalid parameter values.

{
  "error": {
    "code": "bad_request",
    "message": "Missing required parameter: hotel_name",
    "details": "The hotel_name parameter is required for this endpoint"
  }
}

404 Not Found

No results found for the specified hotel and location.

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

Handling Not Found Results

A 404 response doesn't mean your request was invalid - it means no booking links were found. Consider providing users with alternative search suggestions.

Rate Limits

This endpoint is subject to the standard StayAPI rate limits:

  • Free tier: 100 requests per hour, 1,000 per day
  • Professional tier: 1,000 requests per hour, 25,000 per day
  • Enterprise tier: Custom limits available
Learn more about rate limits →
Request
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" \
  -d "include_official=true"
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",
      "official_website": "https://www.fourseasons.com/jimbaran/",
      "kayak": "https://www.kayak.com/hotels/Four-Seasons-Resort-Bali-c47329.h123456.Hotel-Information"
    },
    "platform_count": 7,
    "official_website_detected": true,
    "search_quality": "high",
    "response_time_ms": 245
  }
}