apyhub
▣ GEOLOCATION · TRAVEL

US Reverse Location Lookup API

What it does

Reverse Location Lookup turns latitude and longitude into a location-aware lookup result. Send lat and lon, and optionally a radius_m up to 50,000, to query nearby place or address data around a point on the map.

Use Reverse Location Lookup when you need to attach context to coordinates, such as identifying where a mobile event occurred, enriching a delivery pin, or resolving a GPS reading in a support or logistics workflow. The request is simple: two required query parameters for the coordinate pair, plus an optional search radius in meters with a default of 1,000.

The response is returned as a JSON object with flexible structure, so you can integrate it into your own location-processing pipeline without assuming a fixed field set. That makes it a good fit for applications that need reverse-geocoding-style results while keeping the output adaptable to the source data returned by the service.

GET
Reverse location lookup
https://api.eu.apyhub.com/dosvak/reverse-location-lookup

QUICKSTART

GUIDE

Quickstart

Look up the nearest location for a latitude/longitude pair.

curl -X GET "https://api.eu.apyhub.com/dosvak/reverse-location-lookup?lat=34.0522&lon=-118.2437&radius_m=2000" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema allows additional top-level fields, so the exact response shape may vary.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437,
    "radius_m": 1000
  },
  "feature": {
    "osm_id": 4253186548,
    "name": "Ronald F. Deaton Civic Auditorium",
    "category": "events_venue",
    "lat": 34.05206589960343,
    "lon": -118.2438373,
    "distance_m": 23.62699806699978,
    "source": "point"
  },
  "attribution": [
    {
      "source": "OpenStreetMap contributors",
      "dataset": "OpenStreetMap feature and geometry data",
      "license": "ODbL 1.0",
      "url": "https://www.openstreetmap.org/copyright",
      "notice": "Contains information from OpenStreetMap and its contributors, available under the Open Database License."
    }
  ]
}
TRY ITLIVE · 100 ATOMS
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

Performs a reverse location lookup using latitude and longitude passed as query parameters. The endpoint returns a JSON object, but the output schema does not define any fixed response fields.

Query Parameter(s)

AttributeTypeMandatoryDescription
latNumberYesLatitude coordinate in decimal degrees. Minimum: -90, maximum: 90.
lonNumberYesLongitude coordinate in decimal degrees. Minimum: -180, maximum: 180.
radius_mIntegerNoSearch radius in meters. Default: 1000. Minimum: 50, maximum: 50000.

Response

Returns a JSON object with no fixed top-level fields defined in the schema. The response schema allows additional properties, so the exact shape is not specified here.

Query parameters

Name
Type
Description
latREQUIRED
number
—
lonREQUIRED
number
—
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.