GET

TripAdvisor Hotel Prices API

Extract real-time hotel pricing from multiple providers through TripAdvisor.

Overview

Real-Time Pricing

Get current prices from multiple booking providers including Booking.com, Expedia, Hotels.com, and more.

The TripAdvisor Hotel Prices endpoint provides real-time pricing information from various booking providers for specific dates. Compare prices across platforms and get direct booking links.

Endpoint URL

GET https://api.stayapi.com/v1/tripadvisor/hotel/prices/{location_id}

Parameters

Parameter	Type	Required	Description
location_id	string	Required	TripAdvisor location ID (path parameter)
check_in	string	Required	Check-in date (YYYY-MM-DD)
check_out	string	Required	Check-out date (YYYY-MM-DD)
adults	integer	Optional	Number of adult guests (1-8, default: 2)
rooms	integer	Optional	Number of rooms (1-4, default: 1)
currency	string	Optional	Currency code (default: "USD")

Response Structure

Per-Offer Fields

provider - Provider name (e.g. "Priceline", "Booking.com")
price_per_night - Formatted price per night (e.g. "$140")
total_stay_price - Formatted total stay price
taxes_value - Taxes amount (numeric)
is_lowest_price - Whether this is the lowest price
rooms_remaining - Number of rooms left at this price

Summary Data

lowest_price - Lowest available price
pricing_complete - Whether all providers have responded
has_member_rates - Whether member-only rates exist

Common Providers

Typical booking providers include:

Booking.com

Expedia

Hotels.com

Agoda

Trip.com

Hotel Website

Price Variations

Prices can vary significantly between providers. Always check multiple sources for the best deal.

Request

curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/prices/305165?check_in=2026-04-01&check_out=2026-04-03&adults=2&rooms=1" \
  -H "x-api-key: YOUR_API_KEY"

const locationId = "305165";
const params = new URLSearchParams({
  check_in: "2026-04-01",
  check_out: "2026-04-03",
  adults: "2",
  rooms: "1",
  currency: "USD"
});

const response = await fetch(
  `https://api.stayapi.com/v1/tripadvisor/hotel/prices/${locationId}?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

// Display pricing summary
console.log(`Lowest price: ${data.pricing_summary.lowest_price}`);

// Display all offers sorted by price
console.log("\nPrices by provider:");
data.available_offers.forEach(offer => {
  const tag = offer.is_lowest_price ? " (LOWEST)" : "";
  console.log(`  ${offer.provider}: ${offer.price_per_night}/night (${offer.total_stay_price} total)${tag}`);
});

import requests
from datetime import datetime, timedelta

# Set dates
check_in = (datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d")
check_out = (datetime.now() + timedelta(days=32)).strftime("%Y-%m-%d")

location_id = "305165"
url = f"https://api.stayapi.com/v1/tripadvisor/hotel/prices/{location_id}"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "check_in": check_in,
    "check_out": check_out,
    "adults": 2,
    "rooms": 1,
    "currency": "USD"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Pricing summary
print(f"Lowest price: {data['pricing_summary']['lowest_price']}")

# All offers (already sorted by price)
offers = data["available_offers"]
print(f"\n{len(offers)} Available Rates:")
for i, offer in enumerate(offers, 1):
    tag = " (LOWEST)" if offer["is_lowest_price"] else ""
    print(f"{i}. {offer['provider']:15} {offer['price_per_night']:>8}/night  {offer['total_stay_price']:>10} total{tag}")

Response

{
  "success": true,
  "location_id": 305165,
  "search_params": {
    "check_in": "2026-04-01",
    "check_out": "2026-04-03",
    "adults": 2,
    "rooms": 1,
    "currency": "USD"
  },
  "pricing_summary": {
    "lowest_price": "$140",
    "pricing_complete": true,
    "has_member_rates": false
  },
  "available_offers": [
    {
      "provider": "Priceline",
      "price_per_night": "$140",
      "total_stay_price": "$304",
      "is_lowest_price": true,
      "rooms_remaining": 2,
      "taxes_value": 13
    },
    {
      "provider": "Booking.com",
      "price_per_night": "$173",
      "total_stay_price": "$380",
      "is_lowest_price": false,
      "rooms_remaining": null,
      "taxes_value": 17
    },
    {
      "provider": "Agoda.com",
      "price_per_night": "$170",
      "total_stay_price": "$392",
      "is_lowest_price": false,
      "rooms_remaining": 2,
      "taxes_value": 26
    }
  ],
  "message": "Successfully retrieved hotel pricing",
  "retrieved_at": "2026-02-27T10:55:08Z"
}

{
  "error": "Invalid dates",
  "detail": "Check-out date must be after check-in date",
  "status_code": 400
}