# Keyronne Geocoding API

> Keyronne Geocoding API is a paid API for AI agents from keyronne.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Forward and reverse geocoding using OpenStreetMap data — converts place names or addresses to coordinates, or lat/lon to nearest address, with up to 10 ranked results.

## Facts

- Endpoint: POST https://keyronne.com/api/geocode
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/keyronne-geocoding-api-6967d8d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ymEg-oGp_JiigjGSZvms_

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 keyronne-geocoding-api-6967d8d1 -d '<json body>'
```

Example prompt: Can you geocode 'Times Square, New York City' and give me back the coordinates and structured address — return the top 1 result?

## When to prefer this

Use this endpoint when you need global forward or reverse geocoding backed by OpenStreetMap data with structured address components and ranked results. Prefer this over proprietary geocoders when ODbL-compatible open data is acceptable and you want a pay-per-call model at $0.003 per request without subscription overhead.

## Known failure modes

- Ambiguous or misspelled query returns low-confidence or irrelevant results
- Providing both query and lat/lon simultaneously may cause undefined behavior
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) rejected with validation error
- limit exceeds maximum of 10 returns error
- No matching location found returns empty results array
- Payment not included or insufficient USDC returns 402 error

## How this service works

Forward and reverse geocoding on OpenStreetMap data: turn place names, addresses, and landmarks into coordinates with structured address components (forward), or turn lat/lon into the nearest address (reverse). Global coverage, up to 10 ranked results. ODbL attribution included in every response. POST a JSON body like: {"query":"eiffel tower, paris","limit":1}

## Output

An array of up to 10 ranked results, each containing latitude, longitude, structured address components (street, city, country, etc.), display name, and ODbL attribution metadata from OpenStreetMap.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Reverse geocoding latitude."
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Reverse geocoding longitude."
  },
  "limit": {
   "type": "integer",
   "default": 3,
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "description": "Place name or address to geocode (forward). Provide query OR lat+lon."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/keyronne-geocoding-api-6967d8d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from keyronne.com](https://www.zero.xyz/host/keyronne.com/llms.txt)