# API Acre Reverse Geocode

> API Acre Reverse Geocode is a paid API for AI agents from apiacre.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Converts a latitude/longitude coordinate pair into nearby GeoNames populated places ranked by great-circle distance, with country, region, population, timezone, and feature metadata — served from a bundled dataset with no external network call.

## Facts

- Endpoint: POST https://apiacre.com/v1/data/reverse-geocode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-reverse-geocode-be2f1874
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WdlmnSRSSBqRA02roRHLg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-acre-reverse-geocode-be2f1874 -d '<json body>'
```

Example prompt: What are the 3 nearest populated places within 10 km of latitude 51.5074, longitude -0.1278? I need their country, region, and timezone.

## When to prefer this

Choose this endpoint when you need fast, offline-resolved reverse geocoding to populated places (not street addresses) with structured administrative hierarchy, timezone, and population data from GeoNames — especially when determinism, low latency, and no external dependency at request time matter. Prefer it over street-address geocoders when the use case involves city/region attribution, timezone assignment, or place-name tagging rather than postal precision.

## Known failure modes

- Missing or invalid latitude/longitude returns a validation error
- radius_km exceeding 500 km is capped or rejected
- No populated places within the specified radius returns matched: false with empty results
- Malformed JSON body causes a 400 error
- Very remote coordinates (open ocean, polar regions) may yield zero results within any reasonable radius

## How this service works

Resolve one latitude/longitude pair into bounded, great-circle-distance-ranked nearby GeoNames populated places with country, first-level region, population, timezone, feature code, and source freshness without a request-time network call.

## Output

A JSON object containing a ranked list of nearby GeoNames populated places, each with place name, geoname ID, great-circle distance rank, country (name, ISO2, ISO3, continent code), first-level administrative region (code and name), and dataset metadata including snapshot build date, total alias and place record counts, and whether results were truncated. Also includes query echo, candidate count, and next-action hints for related endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "latitude": {
   "type": "number"
  },
  "longitude": {
   "type": "number"
  },
  "radius_km": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "limit": 3,
    "latitude": 51.5074,
    "radiusKm": 10,
    "longitude": -0.1278
   },
   "source": {
    "dataset": "GeoNames cities500",
    "provider": "GeoNames",
    "aliasRecords": 766415,
    "placeRecords": 235408,
    "snapshotBuiltOn": "2026-08-18"
   },
   "matched": true,
   "results": [
    {
     "name": "London",
     "rank": 1,
     "admin1": {
      "code": "ENG",
      "name": "England"
     },
     "country": {
      "code": "GB",
      "iso3": "GBR",
      "name": "United Kingdom",
      "continentCode": "EU"
     },
     "geonameId": 2643743
    }
   ],
   "version": "apiacre-reverse-geocode/1",
   "limitations": [
    "Coverage follows the GeoNames cities500 extract: populated places above 500 r...",
    "This endpoint returns nearby populated places, not street addresses, parcels,...",
    "The nearest populated place is not proof of the queried coordinate's postal a...",
    "Distances are rounded great-circle distances between coordinates and place ce...",
    "The search radius is capped at 500 km and results use the bundled 2026-08-18 ..."
   ],
   "candidateCount": 99,
   "resultsTruncated": true
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/data/us-weather-forecast",
     "title": "Global weather forecast",
     "method": "POST",
     "reason": "Use the queried coordinates for a separately authorized current global forecast.",
     "service": "data.us-weather-forecast"
    }
   ]
  },
  "service": "data.reverse-geocode",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-acre-reverse-geocode-be2f1874/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)