---
title: "Nearby - Places (Public BETA)"
method: GET
path: "/nearby"
tags: ["Nearby"]
---

# Nearby - Places (Public BETA)

`GET /nearby`

The Nearby API returns nearby places around a specified location.

Results can include points of interest such as cafes, hospitals, and airports, as well as place-level features such as cities, depending on the requested `tag`.

Note: The Nearby API endpoint is presently in BETA. The request or response format may change without notice. While we don't expect to remove any elements, there will be additions.

## Query parameters

- `lat` number, float, required
- `lon` number, float, required
- `tag` string
- `radius` integer
- `limit` integer
- `dedupe` 0 | 1

## Response `200`

OK

- object[]
  - `place_id` string, required — Unique identifier for the place.
  - `licence` string, required — License information for the data.
  - `osm_type` string — Type of OpenStreetMap object.
  - `osm_id` string — Unique identifier for the OpenStreetMap object.
  - `lat` string, required — Latitude of the location.
  - `lon` string, required — Longitude of the location.
  - `display_name` string, required — Formatted address for display.
  - `class` string — The category of this result
  - `type` string — The 'type' of the class/category of this result
  - `address` AddressNearby — Breakdown of the address into elements. All these elements are optional and only those elements that are available for a given location will be returned.
    - `name` string — House name or Point of Interest (POI)
    - `house_number` string — House or Building number
    - `road` string — Roads, Highways, Freeways, Motorways
    - `neighbourhood` string — Neighbourhoods, Allotments, Quarters, Communities
    - `suburb` string — Suburbs, Subdivisions
    - `city` string — Cities, Towns, Villages, Municipalities, Districts, Boroughs, Hamlets
    - `county` string — Counties
    - `state` string — States, Provinces, Regions, State Districts
    - `state_code` string — State or Province Code
    - `postcode` string — Postal Codes, Zipcodes
    - `country` string — Countries, Nation-states
    - `country_code` string — Country Code - 2 letter (ISO 3166-1 alpha-2)
  - `boundingbox` string[], required — List of bounding box coordinates [min_lat, max_lat, min_lon, max_lon].

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — The request has been made from an unauthorized domain.
- `404` — No location or places were found for the given input.
- `429` — Request exceeded the rate-limits set on your account.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/locationiq/apis/locationiq-api-reference.md) · [All operations](https://skmtc.dev/locationiq/apis/locationiq-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/locationiq/locationiq-api-reference/revisions/62f2eab3d1ff/schema)