Reverse geocode (coordinates → nearest address)
Finds the nearest known address to a given lat/lng within radius_m metres from the reference database. Results are sorted by distance ascending and include a distance_m field.
Credits: Stripe-plan keys are charged a flat 1 transaction per request (reverse=1), regardless of limit. Trial/dev keys are charged 1 transaction per returned address, pre-capped to the remaining balance so the call never overdraws. units_charged in the response echoes the number of addresses returned (which equals the trial-key debit; the Stripe debit is always 1).
RapidAPI note: For traffic routed through the RapidAPI gateway, limit is forced server-side to 1 so that one HTTP request maps to exactly one Geocoding Lookups meter decrement. The limit query parameter is silently ignored for RapidAPI clients.
Availability: Available for ~160 countries. Availability is detected per country from the reference DB — any DB carrying an (RT_LAT, RT_LNG)-leading rooftop-coordinate index serves reverse, and the set expands automatically when an index lands. Countries without it return 501 reverse_not_available — currently including che, jpn, tur, kor, isr, arg, chl, vnm, pak, phl, hkg; gbr reverse is served via the PAF host.
Request
- Base URL: https://api.acuris-geo.com
- URL: https://api.acuris-geo.com/reverse
- Auth: one of:
- API key in header X-Acuris-Key
- HTTP bearer
- API key in header X-API-Key
- API key in query parameter key
- none
Query parameters
Country code (see Country codes above).
Search radius in metres. Capped at 50000.
Max results to return. Capped at 10. Ignored for RapidAPI traffic — forced to 1 to align with the per-request Geocoding Lookups meter.
Response
Match found. When limit=1 (default) the body is a single result; when limit>1 the body wraps results: [] with count.
Example response
{
"country": "usa"
}Changes
No recorded changes to this operation across all 1 revision of this API.