Search for a list of places

get

https://api.liteapi.travel/v3.0/data/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

textQuery

string

required

Search query. e.g. 'Manhattan'

type

string

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.

language

string

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

clientIP

string

The IP address of the client making the request.

sessionId

string

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.

Responses

200OK

400Bad request