GET
# TripAdvisor Details from URL API

Extract hotel details directly from any TripAdvisor hotel URL - no location ID needed.

## 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

#### One-Step Solution

Simply provide any TripAdvisor hotel URL and get hotel details in one call.

This endpoint combines URL parsing and detail extraction in one call. Perfect when you have the hotel URL but not the location ID. Returns the same data as the location ID endpoint.

### Endpoint URL

GET https://api.stayapi.com/v1/tripadvisor/hotel/details-from-url 

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.

## Query Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| url | string | Required | Any valid TripAdvisor hotel URL |

## Accepted URL Formats

This endpoint works with any TripAdvisor hotel URL:

Standard format:

`https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html`

With page navigation:

`https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-or10-Hotel.html`

Different domains:

`https://www.tripadvisor.co.uk/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html`

## Response Data

Returns the same hotel information as the location ID endpoint, including:

#### Property Information

- • Hotel name and accommodation type
- • Star rating and price level
- • Ranking and ranking status
- • Canonical hotel URL

#### Location Details

- • Full address
- • GPS coordinates
- • Country code
- • Parent location breadcrumbs

#### Reviews & Ratings

- • Overall rating
- • Category breakdowns
- • Review count
- • Star rating

#### Amenities & Contact

- • Highlighted amenities (partial list)
- • Hero image
- • Price range
- • Phone when available

## Why Use This Endpoint?

#### Best for Automation

Ideal for browser extensions or any workflow where you have URLs but not location IDs.

- No need to parse location IDs from URLs
- Works with any TripAdvisor hotel page URL
- Single API call for hotel details
- Includes the extracted location ID in response
- Perfect for automated integration workflows

Request

```curl
curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/details-from-url?url=https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html" \
  -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-from-url",
  "correlation_id": "example-request-id",
  "provider": "tripadvisor"
}
```