GET

TripAdvisor Hotel Details API

Extract comprehensive hotel information from TripAdvisor using the hotel's location ID.

Overview

Complete Hotel Data

Get detailed hotel information including name, description, contact details, coordinates, address, and special offers.

The TripAdvisor Hotel Details endpoint provides comprehensive hotel information including property details, location data, contact information, and current special offers.

Endpoint URL

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

Parameters

Parameter	Type	Required	Description
location_id	integer	Required	TripAdvisor location ID (path parameter, e.g., 8622290)

Response Structure

Basic Information

name - Hotel name
description - Detailed property description
url - TripAdvisor hotel page URL
place_type - Type of accommodation (e.g., ACCOMMODATION)
local_language - Local language code

Location & Contact

address - Full street address
phone - Hotel phone number (when available)
coordinates - GPS coordinates object
- latitude - Latitude coordinate
- longitude - Longitude coordinate

Special Offers

special_offer - Current special offers object (when available)
- heading - Offer headline
- details - Offer terms and conditions

Common Use Cases

Building hotel profile pages with contact and location data
Displaying hotel locations on maps
Showing current special offers and promotions
Enriching hotel data with TripAdvisor information
Creating hotel comparison tools
Implementing "click to call" or "get directions" features

Data Freshness

Hotel details change less frequently than reviews. Consider caching this data for 24-48 hours to improve performance.

Request

curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/details/8622290" \
  -H "x-api-key: YOUR_API_KEY"

const locationId = 8622290;

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

const data = await response.json();
const hotel = data.data;

console.log(`Hotel: ${hotel.name}`);
console.log(`Address: ${hotel.address}`);
console.log(`Phone: ${hotel.phone}`);
console.log(`Coordinates: ${hotel.coordinates.latitude}, ${hotel.coordinates.longitude}`);

// Display special offers
if (hotel.special_offer) {
  console.log("\nSpecial Offer:");
  console.log(`  ${hotel.special_offer.heading}`);
  console.log(`  ${hotel.special_offer.details}`);
}

import requests

location_id = 8622290
url = f"https://api.stayapi.com/v1/tripadvisor/hotel/details/{location_id}"
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()
hotel = data["data"]

# Display basic information
print(f"Hotel: {hotel['name']}")
print(f"Description: {hotel['description'][:100]}...")

# Location information
print(f"\nLocation:")
print(f"Address: {hotel['address']}")
print(f"Coordinates: {hotel['coordinates']['latitude']}, {hotel['coordinates']['longitude']}")

# Contact information
print(f"\nContact:")
print(f"Phone: {hotel.get('phone', 'N/A')}")

# Special offer
if "special_offer" in hotel:
    print(f"\nSpecial Offer:")
    print(f"  {hotel['special_offer']['heading']}")
    print(f"  {hotel['special_offer']['details']}")

Response

{
  "success": true,
  "location_id": 8622290,
  "data": {
    "name": "Cassia Phuket",
    "description": "Cassia Phuket's an all-suite hotel by Banyan Group and defiantly more than the sum of its parts! Cassia Phuket is the first and only pet friendly hotel with full in-room pet amenities on the island. We've got one or two-bedrooms, each with a zingy, super-chill living space and gorgeous functional kitchen and super cool loft spaces, not to mention some of the best water and sunset views on the island!",
    "url": "/Hotel_Review-g2400063-d8622290-Reviews-Cassia_Phuket-Bang_Tao_Beach_Choeng_Thale_Thalang_District_Phuket.html",
    "phone": "00 66 76 356 999",
    "coordinates": {
      "latitude": 8.000494,
      "longitude": 98.29666
    },
    "address": "64-64/1 Moo 4, Bang Tao Beach, Choeng Thale, Phuket 83110 Thailand",
    "place_type": "ACCOMMODATION",
    "local_language": "th",
    "special_offer": {
      "heading": "25% off plus family perks!",
      "details": "Take a family trip with 25% off and kids stay & dine for free! Room includes breakfast. Kids enjoy buffet dinner on every Mon, Wed and Sat. Unlimited scoop of ice cream for kids daily. Free room upgrade and late check-out when book before 31 Oct 2025"
    }
  },
  "message": "Successfully retrieved hotel details",
  "retrieved_at": "2025-10-04T11:39:34.354323Z"
}

{
  "success": false,
  "location_id": 999999,
  "data": null,
  "message": "Failed to fetch hotel details: 404 Client Error",
  "retrieved_at": "2025-10-03T21:03:03.589620Z"
}