Hotel Detail
2 creditsGet detailed information about a specific hotel including amenities, prices, and room options.
/api/v1/tools/google/hotels/detailParameters
An HTTPS Google Hotels entity URL with the path /travel/hotels/entity/{bookingToken}. The maximum length is 4,096 characters. Provide exactly one target: hotelUrl, bookingToken, or propertyId. The request body is strict. Unknown fields are rejected.
The bookingToken from a Search result. This is the preferred target. It can contain letters, numbers, underscores, and hyphens. The maximum length is 2,048 characters. Provide exactly one target.
Deprecated input alias for bookingToken. The value must be a booking token even though this input is named propertyId. Provide exactly one target.
A real calendar date in YYYY-MM-DD format. It must be today or a future date.
A real calendar date in YYYY-MM-DD format. It must be after checkInDate.
A 3-letter currency code. The API changes letters to uppercase. The default is "USD".
Select result fields. Values must be unique. Use ["*"] alone for all supported fields. If you omit this parameter, the API returns these default fields: "name", "bookingToken", "propertyId", "searchType", "starRating", "propertyType", "latitude", "longitude", "address", "phone", "website", "pricePerNight", "totalPrice", "currency", "priceHistory", "priceBreakdown", "reviewScore", "reviewCount", "ratingDistribution", "amenities", "bookingLinks", "description", "photoCategories", "checkInTime", "checkOutTime". Supported fields: "name", "bookingToken", "propertyId", "placeId", "searchType", "starRating", "propertyType", "latitude", "longitude", "pricePerNight", "totalPrice", "currency", "originalPricePerNight", "originalTotalPrice", "reviewScore", "reviewCount", "thumbnailUrl", "amenities", "photos", "ecoBadge", "sleeps", "bedrooms", "bathrooms", "hashId", "address", "neighborhood", "neighborhoodDescription", "countryCode", "locationHierarchy", "neighborhoodScores", "priceHistory", "priceBreakdown", "ratingDistribution", "reviewSummaryPositive", "reviewSummaryNegative", "featuredReviewSnippets", "aspectSentiments", "externalReviewSources", "photoCategories", "inclusivityLabels", "phone", "website", "googleCategory", "checkInTime", "checkOutTime", "roomTypes", "bookingLinks", "nearbyHotels", "sponsoredHotels", "nearbyVacationRentals", "nearbyPlaces", "nearbyBusinesses", "webResults", "featuredIn", "description".
Response Schema
The Google Hotels detail result.
The selected property fields. Some values can be absent when Google does not return them. Empty required arrays stay in the result.
True when the core hotel data is valid but an optional section did not load.
Optional sections that did not load. Values can be "webResults" and "photoCategories".
Request metadata.
The tool name.
The request cost. The value is 2.
The 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 '{"bookingToken": "ChkIq_atzbv20-8ZGg0vZy8xMXFoMzRoa3pfEAE","checkInDate": "2027-06-10","checkOutDate": "2027-06-12","currency": "USD","fields": ["name", "bookingToken", "latitude", "longitude", "amenities", "bookingLinks"]}'
Response Example
{"data": {"hotel": {"name": "Example Hotel Tokyo","bookingToken": "ChkIq_atzbv20-8ZGg0vZy8xMXFoMzRoa3pfEAE","latitude": 35.6812,"longitude": 139.7671,"amenities": ["Free Wi-Fi","Restaurant"],"bookingLinks": [{"provider": "Example Provider","price": 142,"url": "https://example.com/book","isOfficialSite": false,"freeCancellation": true}]},"partial": false,"failedSections": []},"meta": {"tool": "google-hotels-detail","creditsUsed": 2,"requestId": "req_abc123"}}