# api.agentstools.dev Geocode

> api.agentstools.dev Geocode is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Forward-geocodes a street address or place name worldwide to geographic coordinates and parsed address components using OpenStreetMap Nominatim.

## Facts

- Endpoint: GET https://api.agentstools.dev/geocode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-agentstools-dev-geocode-95ad5ed1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V2Tvh-FVn_RghlciAIceM

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-agentstools-dev-geocode-95ad5ed1
```

Example prompt: What are the GPS coordinates for 1600 Pennsylvania Avenue NW, Washington DC? I need latitude and longitude plus the parsed address components.

## When to prefer this

Choose this endpoint when you need to convert any free-text address or place name (worldwide, any language) to coordinates without managing an API key, and when you also want structured parsed address components back alongside coordinates. It's especially useful for agents performing location enrichment, mapping, or routing tasks.

## Known failure modes

- Address not found or ambiguous — returns empty results array
- Malformed or missing address query parameter — returns 400 error
- Nominatim rate limiting or temporary unavailability — returns 5xx error
- Non-existent or fictional place returns empty result set

## How this service works

Forward-geocode a street address or place name (WORLDWIDE) to coordinates + parsed address components via OpenStreetMap Nominatim (public, keyless).

## Output

Returns geographic coordinates (latitude and longitude), a structured parsed address broken into components (road, city, state, country, postcode, etc.), a display name string, and optionally a bounding box — all sourced from OpenStreetMap Nominatim, no API key required.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Street address or place name (any country)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-agentstools-dev-geocode-95ad5ed1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)