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

# Search places

`GET /v1/places/search`

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.net/latlng/apis/latlng-api.md) · [All operations](https://skmtc.net/latlng/apis/latlng-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latlng/latlng-api/versions/d6031c15b5ec/schema)