GET

TripAdvisor Details from URL API

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

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

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

// Any TripAdvisor hotel URL
const hotelUrl = "https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html";

const params = new URLSearchParams({ url: hotelUrl });

const response = await fetch(
  `https://api.stayapi.com/v1/tripadvisor/hotel/details-from-url?${params}`,
  {
    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

# Any TripAdvisor hotel URL
hotel_url = "https://www.tripadvisor.com/Hotel_Review-g60945-d83189-Reviews-Stanley_Hotel-Estes_Park_Colorado.html"

url = "https://api.stayapi.com/v1/tripadvisor/hotel/details-from-url"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"url": hotel_url}

response = requests.get(url, headers=headers, params=params)
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-from-url",
  "correlation_id": "example-request-id",
  "provider": "tripadvisor"
}