GET

TripAdvisor Hotel Details API

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

Copy for your AI agent

Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.

Availability of hotel details

A successful response identifies the hotel with numeric location_id and data.name. Other property fields are optional: a valid response can contain only basic identity information and ranking_status.

ranking_status is ok when a ranking is available, no_pop_index when the hotel has no ranking, not_in_top300_of_geo when it is outside the destination coverage window, or no_parent_geo when no destination is available. geo_search_failed means additional details are temporarily unavailable; the basic hotel information is still returned successfully. When present, ranking contains optional rank, total, and localized fields.

amenities contains highlighted amenities only, not the complete About-box list, and is omitted when unavailable. The response does not include contact.website or num_rooms.

An unknown hotel returns HTTP 404. An unavailable or malformed hotel identity response returns HTTP 502 with Problem Details; it is not reported as a missing hotel.

Overview

Hotel Details

Get hotel identity, ratings, structured address, phone, coordinates, and highlighted amenities when available.

The TripAdvisor Hotel Details endpoint returns hotel identity, ratings, location data, phone, and highlighted amenities when available.

Endpoint URL

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

Fields inside data are conditional on upstream coverage. amenities contains highlighted amenities only, not the full About-box list. contact.website and num_rooms are not returned, even when TripAdvisor displays them in its About box. If the hotel is outside the parent-area search window, the response may contain only its name and parent location data.

Parameters

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

Response Structure

Basic Information

name - Hotel name
accommodation_type - Accommodation category
hotel_url - TripAdvisor hotel page URL
rating - Overall traveler rating (1–5)
num_reviews - Review count

Location & Contact

address - Object containing street, city, state, country, postal_code, and full_address
contact.phone - Hotel phone number (when available)
coordinates - GPS coordinates object
- latitude - Latitude coordinate
- longitude - Longitude coordinate

Amenities & Ranking

amenities - Highlighted amenity names (when available)
ranking.localized - Localized hotel ranking
ranking_status - Whether ranking data was available

Common Use Cases

Building hotel profile pages with contact and location data
Displaying hotel locations on maps
Comparing ratings and highlighted hotel amenities
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/83189" \
  -H "x-api-key: YOUR_API_KEY"

const locationId = 83189;

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();
if (!response.ok) throw new Error(data.detail || "Request failed");
const hotel = data.data;

console.log(`Hotel: ${hotel.name}`);
console.log(`Address: ${hotel.address?.full_address || "Not available"}`);
console.log(`Phone: ${hotel.contact?.phone || "Not available"}`);
console.log(`Ranking: ${hotel.ranking?.localized || "Not available"}`);
if (hotel.rating != null) console.log(`Rating: ${hotel.rating}/5`);

// These are highlighted amenities, not the full property amenity list.
for (const amenity of hotel.amenities || []) {
  console.log(amenity);
}

import requests

location_id = 83189
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)
response.raise_for_status()
data = response.json()
hotel = data["data"]

print("Hotel:", hotel["name"])
print("Address:", (hotel.get("address") or {}).get("full_address", "Not available"))
print("Phone:", (hotel.get("contact") or {}).get("phone", "Not available"))
print("Ranking:", (hotel.get("ranking") or {}).get("localized", "Not available"))

# These are highlighted amenities, not the full property amenity list.
for amenity in hotel.get("amenities", []):
    print(amenity)

Response

{
  "success": true,
  "location_id": 83189,
  "data": {
    "location_id": 83189,
    "name": "Stanley Hotel",
    "accommodation_type": "HOTEL",
    "parent_location_id": 60945,
    "parent_geo_breadcrumbs": [
      "Estes Park",
      "Colorado",
      "United States",
      "North America",
      "World"
    ],
    "coordinates": {
      "latitude": 40.38291,
      "longitude": -105.51906
    },
    "address": {
      "street": "333 Wonderview Avenue",
      "city": "Estes Park",
      "state": "Colorado",
      "country": "United States",
      "postal_code": "80517",
      "full_address": "333 Wonderview Avenue, Estes Park, CO 80517"
    },
    "contact": {
      "phone": "+1 970-586-3371"
    },
    "rating": 3.6,
    "num_reviews": 4028,
    "star_rating_tag_id": 9568,
    "star_rating": 3.0,
    "subratings": {
      "cleanliness": 4.04,
      "location": 4.69,
      "service": 3.8,
      "value": 3.27
    },
    "ranking": {
      "rank": 114,
      "total": 116,
      "localized": "#30 of 31 hotels in Estes Park"
    },
    "price_level": {
      "minimum": 202,
      "maximum": 476
    },
    "main_image": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/06/31/4d/e3/stanley-hotel.jpg?w=2000&h=1331&s=1",
    "country_code": "US",
    "hotel_url": "https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html",
    "ranking_status": "ok",
    "amenities": [
      "Restaurant",
      "Bar/Lounge",
      "Family Friendly"
    ]
  },
  "message": "Successfully retrieved hotel details",
  "retrieved_at": "2026-10-15T16:05:44.569860Z"
}

{
  "type": "https://api.stayapi.com/errors/upstream-error",
  "title": "Upstream Error",
  "status": 502,
  "detail": "The upstream service could not complete the request.",
  "error_code": "UPSTREAM_ERROR",
  "instance": "/v1/tripadvisor/hotel/details/8622290",
  "correlation_id": "example-request-id",
  "provider": "tripadvisor"
}