GET

Google Travel Resolve API

Resolve a named hotel once, then reuse its durable token across Google Travel.

Overview

Turn a hotel name and city into Google Travel entity_token candidates for property-level requests.

Contract note

Pick the best place_name match when Google returns multiple candidates. Cache its entity_token for Summary, Info, Photos, Prices, Similar, and Nearby calls.

Endpoint URL

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

Parameters

Parameter	Type	Required	Description
query	string	Required	Hotel name plus city, for example Barceló Fortina Sliema Malta.
hl	string	Optional	UI language code. Default: en.
gl	string	Optional	Region or country code. Default: us.

Response schema

Field	Type	Description
success	boolean	Whether the resolver completed successfully.
query	string	The submitted hotel query.
results	array	Candidate matches with place_name and the entity_token used by property endpoints.

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 Search Google Travel Review Summary Google Travel Hotel Info Google Travel Photos Google Travel Prices Google Travel Similar Hotels Google Travel Nearby Places

Request

curl -G "https://api.stayapi.com/v1/google_travel/resolve" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "query=Barcelo Fortina Sliema Malta" \
  --data-urlencode "hl=en" \
  --data-urlencode "gl=us"

const params = new URLSearchParams({"query":"Barcelo Fortina Sliema Malta","hl":"en","gl":"us"});
const response = await fetch("https://api.stayapi.com/v1/google_travel/resolve?" + 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/resolve",
    params={"query":"Barcelo Fortina Sliema Malta","hl":"en","gl":"us"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "query": "Barcelo Fortina Sliema Malta",
  "results": [
    {
      "entity_token": "ChkI-tSR2IGm6OI7Gg0vZy8xMWg4NThxeGJ0EAE",
      "place_name": "Barceló Fortina Malta"
    }
  ]
}