GET

Google Travel Photos API

Pull the published image gallery for one hotel.

Overview

Get a de-duplicated Google Travel hero and gallery photo set with dimensions and available caption highlights.

Endpoint URL

GET https://api.stayapi.com/v1/google_travel/photos

Parameters

Parameter	Type	Required	Description
entity_token	string	Required	Durable Google Travel token returned by Resolve or Search. Use this token, not hotel_id, for property drilldowns.
hl	string	Optional	UI language code. Default: en.
gl	string	Optional	Region or country code. Default: us.

Response schema

Field	Type	Description
count	integer	Number of de-duplicated photos returned.
photos	array	HTTPS image URLs with width, height, photo_id, and optional caption.

Identifier workflow

Resolve once, reuse the token

Resolve a hotel name or run Search to get an entity_token. Cache that token and use it for Summary, Info, Photos, Prices, Similar, and Nearby requests.

Related Google Travel endpoints

Google Travel Resolve Google Travel Search Google Travel Review Summary Google Travel Hotel Info Google Travel Prices Google Travel Similar Hotels Google Travel Nearby Places

Request

curl -G "https://api.stayapi.com/v1/google_travel/photos" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "entity_token=ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE" \
  --data-urlencode "hl=en" \
  --data-urlencode "gl=us"

const params = new URLSearchParams({"entity_token":"ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE","hl":"en","gl":"us"});
const response = await fetch("https://api.stayapi.com/v1/google_travel/photos?" + params, {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/google_travel/photos",
    params={"entity_token":"ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE","hl":"en","gl":"us"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "entity_token": "ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE",
  "count": 22,
  "photos": [
    {
      "url": "https://lh3.googleusercontent.com/gps-cs-s/example=s287-w287-h192-k-no",
      "width": 287,
      "height": 192,
      "photo_id": "CIHM0ogKEICAgICexample",
      "caption": "Panoramic views of the Mediterranean Sea and Valletta"
    }
  ]
}