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

Response

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

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