GET
# TripAdvisor Hotel Details API

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

## 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
curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/details/83189" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

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

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