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 namedescription- Detailed property descriptionurl- TripAdvisor hotel page URLplace_type- Type of accommodation (e.g., ACCOMMODATION)local_language- Local language code
Location & Contact
address- Full street addressphone- Hotel phone number (when available)coordinates- GPS coordinates objectlatitude- Latitude coordinatelongitude- Longitude coordinate
Special Offers
special_offer- Current special offers object (when available)heading- Offer headlinedetails- 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" }