▣ GEOLOCATION · TRAVEL

Find Nearby places In US API

What it does

Nearby Places returns locations near a latitude and longitude. Send lat and lon, and you can also narrow the search with limit and radius_m.

Use Nearby Places when you need place suggestions around a user, a delivery stop, a venue, or any map coordinate. The request is simple: provide a point on the map, then tune how many results you want back and how far out to search. The response schema is open-ended, so expect a structured list of nearby results without assuming a fixed set of fields.

This is a good fit for location-based search, local discovery features, store finders, route planning, and map interfaces that need context around a point rather than a single address. It is also useful when you already have coordinates from geocoding or GPS and need the surrounding places to drive the next step in your workflow.

GET

Find Nearby places

https://api.eu.apyhub.com/dosvak/nearby-places

QUICKSTART

GUIDE

Quickstart

Find nearby places using a latitude and longitude.

curl -X GET "https://api.eu.apyhub.com/dosvak/nearby-places?lat=34.0522&lon=-118.2437" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with additional properties enabled, so the response is an object whose exact fields may vary.

{
  "input": {
    "lat": 40.758,
    "lon": -73.9855,
    "radius_m": 5000,
    "limit": 10
  },
  "count": 10,
  "results": [
    {
      "osm_id": 5706568332,
      "name": "Theater District",
      "category": "unknown",
      "distance_m": 5.82
    }
  ],
  "attribution": [ 
]
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns nearby places for a given latitude and longitude. You can optionally limit the number of results and set the search radius in meters.

Query Parameter(s)

Attribute	Type	Mandatory	Description
lat	Number	Yes	Latitude. Minimum `-90`, maximum `90`.
lon	Number	Yes	Longitude. Minimum `-180`, maximum `180`.
limit	Integer	No	Maximum number of results to return. Default `20`, minimum `1`, maximum `200`.
radius_m	Integer	No	Search radius in meters. Default `500`, minimum `50`, maximum `10000`.

Response

Returns a JSON object containing the request input, the total number of places found, and a list of nearby places. Individual place objects may include additional provider-specific fields.

Query parameters

Name

Type

Description

latREQUIRED

number

—

lonREQUIRED

number

—

limitOPTIONAL

integer

—

DEFAULT 20

radius_mOPTIONAL

integer

—

DEFAULT 500

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.