GET

Hotel Details API

Get comprehensive hotel information including amenities, location, contact details, photos, and more.

Overview

Complete Hotel Information

Access detailed hotel profiles with all the information needed to display rich hotel listings and details pages.

The Hotel Details endpoint provides comprehensive information about hotels including descriptions, amenities, contact information, photos, location data, and more. Perfect for building detailed hotel profile pages.

Endpoint URL

GET https://api.stayapi.com/v1/booking/hotel/details

Parameters

Parameter	Type	Required	Description
url	string	Required	The hotel URL slug from Booking.com (e.g., "le-grand-hotel-paris")

Request

curl -X GET "https://api.stayapi.com/v1/booking/hotel/details" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G \
  -d "url=le-grand-hotel-paris"

const response = await fetch("https://api.stayapi.com/v1/booking/hotel/details?" +
  new URLSearchParams({
    url: "le-grand-hotel-paris"
  }), {
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data.data.amenities);

import requests

url = "https://api.stayapi.com/v1/booking/hotel/details"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

# Using hotel slug
params = {
    "url": "le-grand-hotel-paris"
}

# Or using full URL
params_full_url = {
    "url": "https://www.booking.com/hotel/fr/le-grand-hotel-paris.html"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(f"Hotel: {data[\"data\"][\"name\"]}")
print(f"Rating: {data[\"data\"][\"star_rating\"]} stars")

Response

{
  "status": "success",
  "data": {
    "hotel_id": "hotel_123",
    "name": "Le Grand Hotel InterContinental",
    "description": "A legendary luxury hotel in the heart of Paris, offering elegant accommodations and world-class service since 1862.",
    "address": "2 Rue Scribe, 75009 Paris, France",
    "coordinates": {
      "latitude": 48.871586,
      "longitude": 2.330359
    },
    "star_rating": 5,
    "review_rating": 4.8,
    "total_reviews": 2847,
    "photos": [
      "https://images.booking.com/hotel_123_main.jpg",
      "https://images.booking.com/hotel_123_lobby.jpg",
      "https://images.booking.com/hotel_123_room.jpg"
    ],
    "amenities": [
      "Free WiFi",
      "Spa",
      "Fitness Center",
      "Restaurant",
      "Bar",
      "Room Service",
      "Concierge",
      "Valet Parking"
    ],
    "contact": {
      "phone": "+33 1 40 07 32 32",
      "email": "[email protected]",
      "website": "https://www.ihg.com/intercontinental/hotels/paris"
    },
    "check_in": "15:00",
    "check_out": "12:00",
    "languages_spoken": ["French", "English", "Spanish", "German"],
    "currency": "EUR"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Hotel not found",
    "details": "No hotel found with the specified URL. Please check the hotel URL parameter."
  }
}