---
title: "Search for a list of places"
method: GET
path: "/data/places"
tags: ["Places"]
---

# Search for a list of places

`GET /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.

## Query parameters

- `textQuery` string, required
- `type` string
- `language` string
- `clientIP` string
- `sessionId` string

## Response `200`

OK

- object
  - `data` object[]
    - `placeId` string, required — A unique identifier for the place, typically used in further requests or lookups.
    - `displayName` string, required — A human-friendly name or label for the place.
    - `formattedAddress` string, required — The full address for the place, including street, city, country, etc.
    - `types` string[] — A list of categories or designations describing the place (e.g. 'hotel', 'lodging').

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)