Skip to content
APIStead
Weather & GeospatialVerifiedPreview

Geocoding & Reverse Geocoding API

Address to coordinates, coordinates to address.

About this API

Geocoding is a foundational agent tool. This API handles forward geocoding (address to coordinates) and reverse geocoding (coordinates to address), with a confidence score and normalized components.

It is designed for chaining: the response is small, stable and includes a `place_id` so an agent can refer to the same place across calls. The preview uses OpenStreetMap Nominatim with a proper user agent and caching. For production volume, swap in a commercial geocoder behind the same response shape.

For AI agents

Convert a free-text address or place into coordinates and a normalised address, or reverse geocode coordinates.

Scope

Does not validate postal deliverability or rooftop accuracy. Uses OpenStreetMap data and is not a legal boundary source.

Endpoints

MethodRoutePrice
GET/geocode?address={address}$0.001
GET/reverse?lat={lat}&lon={lon}$0.001

Example request

request
GET https://apistead.qd.je/api/v1/geocode?address=10%20Downing%20Street%20London

Example response

200 application/json
{
  "lat": 51.5034,
  "lon": -0.1276,
  "source": "openstreetmap",
  "place_id": "osm:relation:1879842",
  "confidence": 0.95,
  "formatted_address": "10 Downing Street, London, SW1A 2AA, United Kingdom"
}

Verification

Verified2 of 2 routes verified

APIStead paid one named route from its own wallet, received real product back, and published the on-chain USDC receipt. The badge covers that route, not the whole listing.

Last verified
13 Nov 2026

Use cases

  • Convert an address to coordinates for a map
  • Normalize a user-provided location
  • Resolve coordinates from a photo or device

Agent intents

Phrases an agent can use to find this route.

geocode an addressturn coordinates into an addressfind latitude and longitude for a placenormalise an address for an agent

Changelog

1.0.0release11 Nov 2026

Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

By APIStead Labs