GET

Google Travel Nearby Places API

Pull the points of interest Google Travel associates with one hotel.

Overview

Get attractions, transit, airports, and restaurants near a hotel with ratings, coordinates, and travel times.

Endpoint URL

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

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
groups	array	Points of interest grouped by category and display label.
groups[].pois	array	Places with rating, review count, description, coordinates, and drive or walk time.

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 Similar Hotels

Request

curl -G "https://api.stayapi.com/v1/google_travel/nearby" \
  -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/nearby?" + 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/nearby",
    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",
  "groups": [
    {
      "category": "nearby_poi",
      "label": "Points of interest",
      "pois": [
        {
          "name": "St. John's Co-Cathedral",
          "rating": 4.8,
          "review_count": 25044,
          "description": "Elaborately adorned place of worship, completed in 1578.",
          "latitude": 35.8975921,
          "longitude": 14.5124951,
          "drive_time": "15 min",
          "walk_time": null
        }
      ]
    }
  ]
}