▣ GEOLOCATION · TRAVEL

Find Nearby Places in US by Category API

What it does

Nearby Places returns places in a chosen category around a latitude and longitude. Send a lat, lon, and category, and you can also set limit and radius_m to control how many results come back and how far from the point to search.

Use Nearby Places when you need location-aware results without building your own place search layer. A delivery app can look up nearby restaurants, a travel app can surface attractions around a hotel, and a local directory can filter relevant businesses around a user’s current position.

The request schema is simple: lat and lon define the center point, category selects the type of place, limit caps the result count, and radius_m sets the search radius in meters. The response schema is generic and may include additional fields, so treat it as a place search payload rather than a fixed record shape.

Nearby Places fits well anywhere you need category-based nearby search from coordinates, with predictable query parameters and a straightforward geolocation workflow.

GET

Find Nearby Places

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

QUICKSTART

GUIDE

Quickstart

Find nearby places for a category using your latitude, longitude, and category as query parameters.

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

What you'll get back

Returns a JSON object containing the search input, matching nearby places, the total number of results, and related metadata.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437,
    "category": "restaurant",
    "radius_m": 1000,
    "limit": 5
  },
  "count": 5,
  "results": [
    {
      "name": "Señor Fish",
      "category": "restaurant",
      "distance_m": 132.72
    }
  ],
  "attribution": [
  ]
}

TRY ITLIVE · 100 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 specified category around the provided latitude and longitude. The request lets you control the search radius and result limit through query parameters.

Query Parameter(s)

Attribute	Type	Mandatory	Description
lat	Number	Yes	Latitude in decimal degrees. Minimum `-90`, maximum `90`.
lon	Number	Yes	Longitude in decimal degrees. Minimum `-180`, maximum `180`.
limit	Integer	No	Maximum number of results to return. Default `50`; minimum `1`, maximum `200`.
category	String	Yes	Category to search for. Minimum length `2`.
radius_m	Integer	No	Search radius in meters. Default `1000`; minimum `50`, maximum `50000`.

Response

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

Query parameters

Name

Type

Description

latREQUIRED

number

—

lonREQUIRED

number

—

limitOPTIONAL

integer

—

DEFAULT 50

categoryREQUIRED

string

—

radius_mOPTIONAL

integer

—

DEFAULT 1000

▣ 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.