GET

Google Travel Similar Hotels API

Build a nearby comparison set around one Google Travel property.

Overview

Get similar hotels and nearby vacation rentals, including a reusable entity_token for each result.

Contract note

Every neighboring hotel or rental can carry its own entity_token. Feed that token into any property-level Google Travel endpoint to pivot.

Endpoint URL

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

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
similar_hotels	array	Nearby hotel matches with token, rating, class, distance, price, comparison copy, and photo.
vacation_rentals	array	Nearby rentals with identity, token, and available price.

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 Photos Google Travel Prices Google Travel Nearby Places

Request

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

const params = new URLSearchParams({"entity_token":"ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE","hl":"en","gl":"mt"});
const response = await fetch("https://api.stayapi.com/v1/google_travel/similar?" + 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/similar",
    params={"entity_token":"ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE","hl":"en","gl":"mt"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "entity_token": "ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE",
  "similar_hotels": [
    {
      "name": "Grand Hotel Excelsior Malta",
      "entity_token": "ChcIzuWhytbGxuwsGgsvZy8xdmY1NHI0ehAB",
      "rating": 4.4,
      "review_count": 4595,
      "distance": "1.2 km away",
      "price": {
        "formatted": "$266",
        "value": 265.54
      }
    }
  ],
  "vacation_rentals": [
    {
      "name": "Seaside Bliss, Sliema",
      "entity_token": "CiQIo5WPjrHdExample",
      "price": {
        "formatted": "$486",
        "value": 485.73
      }
    }
  ]
}