Hotel Photos

2 credits

Get photos for a hotel property.

POST/api/v1/tools/google/hotels/photos

Parameters

hotelUrlstring

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

propertyIdstring

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

maxPhotosnumber

Max photos. Defaults to 0 (all).

fieldsstring[]

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

Response Schema

dataobject

Google Hotels photos result

photosobject[]

Array of hotel photos

countnumber

Total number of photos returned

metaobject

Request metadata

toolstring

Tool name (google-hotels-photos)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/hotels/photos \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "propertyId": "ChYIq_X...",
    "maxPhotos": 10
  }'

Response Example

{
  "data": {
    "photos": [
      {
        "url": "https://lh3.googleusercontent.com/p/AF1Q...",
        "caption": "Deluxe Room",
        "category": "room",
        "width": 1920,
        "height": 1080
      },
      {
        "url": "https://lh3.googleusercontent.com/p/AF1Q...",
        "caption": "Hotel Exterior",
        "category": "exterior",
        "width": 1920,
        "height": 1280
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "google-hotels-photos",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}