Hotel Detail

2 credits

Get detailed information about a specific hotel including amenities, prices, and room options.

POST/api/v1/tools/google/hotels/detail

Parameters

hotelUrlstring

Google Hotels URL containing /entity/ token. Either hotelUrl or propertyId required.

propertyIdstring

Booking token from search results. Either hotelUrl or propertyId required.

checkInDatestringrequired

Check-in date in YYYY-MM-DD format.

checkOutDatestringrequired

Check-out date in YYYY-MM-DD format.

adultsnumber

Number of adults (1-9). Defaults to 2.

childrennumber

Number of children (0-9). Defaults to 0.

roomsnumber

Number of rooms (1-9). Defaults to 1.

currencystring

3-letter currency code. Defaults to "USD".

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all fields.

Response Schema

dataobject

Google Hotels detail result

namestring

Hotel name

addressstring

Full address

ratingnumber

Guest rating (out of 5)

reviewCountnumber

Number of reviews

hotelClassnumber

Star rating (1-5)

descriptionstring

Hotel description

amenitiesstring[]

List of amenities

pricesobject[]

Pricing from multiple providers

checkInstring

Check-in time

checkOutstring

Check-out time

latitudenumber

Latitude coordinate

longitudenumber

Longitude coordinate

websitestring

Hotel website URL

phonestring

Hotel phone number

nearbyAttractionsobject[]

Nearby points of interest

metaobject

Request metadata

toolstring

Tool name (google-hotels-detail)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/hotels/detail \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "propertyId": "ChYIq_X...",
    "checkInDate": "2026-07-01",
    "checkOutDate": "2026-07-05"
  }'

Response Example

{
  "data": {
    "name": "Hotel Le Marais",
    "address": "12 Rue des Archives, 75004 Paris, France",
    "rating": 4.5,
    "reviewCount": 1243,
    "hotelClass": 4,
    "description": "Boutique hotel in the heart of the Marais district...",
    "amenities": [
      "free_wifi",
      "restaurant",
      "bar",
      "air_conditioning",
      "room_service"
    ],
    "prices": [
      {
        "provider": "Booking.com",
        "price": 780,
        "currency": "USD",
        "url": "https://www.booking.com/hotel/fr/le-marais..."
      },
      {
        "provider": "Hotels.com",
        "price": 795,
        "currency": "USD",
        "url": "https://www.hotels.com/ho123456..."
      }
    ],
    "checkIn": "15:00",
    "checkOut": "11:00",
    "latitude": 48.8566,
    "longitude": 2.3522,
    "website": "https://www.hotel-lemarais.com",
    "phone": "+33 1 42 72 00 00"
  },
  "meta": {
    "tool": "google-hotels-detail",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/google/hotels/detail \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"propertyId": "ChYIq_X...",

"checkInDate": "2026-07-01",

"checkOutDate": "2026-07-05"

{

"data": {

"name": "Hotel Le Marais",

"address": "12 Rue des Archives, 75004 Paris, France",

"rating": 4.5,

"reviewCount": 1243,

"hotelClass": 4,

"description": "Boutique hotel in the heart of the Marais district...",

"amenities": [

"free_wifi",

"restaurant",

"bar",

"air_conditioning",

"room_service"

"prices": [

{

"provider": "Booking.com",

"price": 780,

"currency": "USD",

"url": "https://www.booking.com/hotel/fr/le-marais..."

{

"provider": "Hotels.com",

"price": 795,

"currency": "USD",

"url": "https://www.hotels.com/ho123456..."

}

"checkIn": "15:00",

"checkOut": "11:00",

"latitude": 48.8566,

"longitude": 2.3522,

"website": "https://www.hotel-lemarais.com",

"phone": "+33 1 42 72 00 00"

"meta": {

"tool": "google-hotels-detail",

"creditsUsed": 2,

"requestId": "req_abc123"

}