Sign in

v1

latestOpenAPI 3.0.02026-07-247251950.2 KB
Places

Search for a list of places

Overview

Search for places, locations, and areas using Google Places API. Returns a list of matching places that can be used to search for hotels within specific boundaries.

Pricing: $0.01 per request

When to Use

  • Location autocomplete - Build location search with autocomplete suggestions
  • Place selection - Let users select cities, airports, or areas
  • Hotel search boundaries - Get Place IDs to restrict hotel searches to specific regions
  • Location discovery - Find places by name or description

What You Get

  • Place list - Multiple matching places with details
  • Place IDs - Unique identifiers for use in hotel searches
  • Location information - Names, addresses, and location types
  • Formatted addresses - Human-readable addresses for display

Key Features

  • Multiple types - Search for cities, airports, hotels, or other place types
  • Type filtering - Specify place types (e.g., 'locality,airport,hotel')
  • Smart defaults - Automatically excludes less relevant types unless specified
  • Relevance ordering - Results sorted by relevance using Google's ranking

Quick Start

Provide a textQuery (e.g., "Manhattan") and optionally specify type to filter results. Returns matching places with Place IDs you can use in hotel searches.

get/data/places

Query parameters

textQuerystring required

Search query. e.g. 'Manhattan'

typestring

Restricts the results to places matching the specified type(s). You can specify a single type (e.g., 'hotel') or multiple types as a comma-separated list (e.g., 'locality,airport,hotel'). Common types include: 'locality' (cities), 'airport', 'hotel', 'lodging', 'establishment', 'point_of_interest'. When multiple types are provided, results from all types are merged and ordered by relevance.

languagestring

The language code, indicating in which language the results should be returned. e.g. 'en'

clientIPstring

The IP address of the client making the request.

sessionIdstring

Optional Google Places billing session ID. When provided, this autocomplete call is bundled into a session settled by a subsequent place details call, reducing billing costs. Can also be passed via the X-Places-Session-Id header (header takes priority). If omitted, the server manages a fallback session automatically.

Response

OK