---
title: "Search places"
method: GET
path: "/v1/places/search"
tags: ["Places"]
---

# Search places

`GET /v1/places/search`

## Request

- Base URL: `https://api.latlng.work`
- URL: `https://api.latlng.work/v1/places/search`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/latlng/apis/latlng-api/docs/v1/places/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for places by name with optional location and category filters.

## Query parameters

- `api_key` string
- `q` string, required
- `lat` number, double
- `lon` number, double
- `type` string
- `category` string
- `country` string
- `limit` integer

## Response `200`

Search places response.

- PlacesResponse
  - `type` string
  - `source` string
  - `query` string
  - `center` object
    - `lat` number
    - `lon` number
  - `radius_m` integer
  - `count` integer
  - `places` Place[]
    - `id` string
    - `name` string
    - `category` string
    - `lat` number
    - `lon` number
    - `confidence` number
    - `country` string
    - `region` string
    - `locality` string
    - `brand` string
    - `distance_m` number

## Other responses

- `400`: Bad request or invalid parameters.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/latlng/apis/latlng-api.md) - [All operations](https://skmtc.dev/latlng/apis/latlng-api/llms.txt) - [OpenAPI document](https://skmtc.dev/latlng/apis/latlng-api/revisions/d6031c15b5ec?raw)