{
  "id": "geocoding-api",
  "slug": "geocoding-api",
  "name": "Geocoding & Reverse Geocoding API",
  "provider": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "verified": true
  },
  "category": "Weather & Geospatial",
  "tagline": "Address to coordinates, coordinates to address.",
  "description": "Forward and reverse geocoding with normalized address components, confidence and a stable place ID.",
  "agent_summary": "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.",
  "intent_phrases": [
    "geocode an address",
    "turn coordinates into an address",
    "find latitude and longitude for a place",
    "normalise an address for an agent"
  ],
  "faqs": [],
  "code_examples": [],
  "price": {
    "min_usdc": 0.001,
    "max_usdc": 0.001,
    "unit": "per_call"
  },
  "payment": {
    "protocol": "x402",
    "protocol_version": 2,
    "network": "eip155:8453",
    "network_name": "Base",
    "asset": "USDC",
    "price_min_usdc": 0.001,
    "price_max_usdc": 0.001,
    "unit": "per_call",
    "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
    "authoritative_source": "402_challenge"
  },
  "networks": [
    "base"
  ],
  "primary_network": "base",
  "verification": "verified",
  "verification_detail": {
    "state": "verified",
    "verified_routes": 2,
    "total_routes": 2,
    "last_verified_at": "2026-11-13T13:52:22.884Z",
    "receipt_url": "https://basescan.org/tx/0x895d6612a320ee74cb276d1ecd31da3768f208d4d4919c4d21ea67b07e3b9cf0"
  },
  "verified_routes": 2,
  "total_routes": 2,
  "reliability": {
    "score": 87,
    "band": "caution",
    "uptime30d": 87,
    "lastCheckedAt": "2026-11-14T04:35:10.718Z"
  },
  "last_verified_at": "2026-11-13T13:52:22.884Z",
  "receipt_url": "https://basescan.org/tx/0x895d6612a320ee74cb276d1ecd31da3768f208d4d4919c4d21ea67b07e3b9cf0",
  "base_url": "https://apistead.qd.je/api/v1",
  "mcp_endpoint": "https://apistead.qd.je/mcp",
  "docs_url": "https://apistead.qd.je/api",
  "tags": [
    "geocoding",
    "maps",
    "address",
    "places",
    "coordinates",
    "osm"
  ],
  "use_cases": [
    "Convert an address to coordinates for a map",
    "Normalize a user-provided location",
    "Resolve coordinates from a photo or device"
  ],
  "links": {
    "docs": "https://apistead.qd.je/api",
    "json": "https://x402.apistead.qd.je/api/apis/geocoding-api",
    "markdown": "https://x402.apistead.qd.je/api/apis/geocoding-api/md",
    "routes": "https://x402.apistead.qd.je/agent/routes?id=geocoding-api",
    "receipts": "https://x402.apistead.qd.je/agent/receipts?id=geocoding-api",
    "api_reference": "https://x402.apistead.qd.je/api",
    "mcp_guide": "https://x402.apistead.qd.je/mcp-docs",
    "skill": "https://x402.apistead.qd.je/skill",
    "openapi": "https://x402.apistead.qd.je/openapi.json"
  },
  "demo": true,
  "long_description": "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.\n\nIt 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.",
  "provider_detail": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "description": "First-party data APIs built and verified by APIStead. US ZIP codes, IP intelligence, geocoding, weather, email and public records, all priced per call.",
    "website": "https://apistead.qd.je",
    "verified": true,
    "firstParty": true
  },
  "routes": [
    {
      "method": "GET",
      "path": "/reverse?lat={lat}&lon={lon}",
      "url": "https://apistead.qd.je/api/v1/reverse?lat={lat}&lon={lon}",
      "price_usdc": 0.001,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Reverse geocode a coordinate.",
      "example_request": "GET https://apistead.qd.je/api/v1/reverse?lat=51.5034&lon=-0.1276",
      "example_response": {
        "city": "London",
        "source": "openstreetmap",
        "country": "United Kingdom",
        "place_id": "osm:relation:1879842",
        "country_code": "gb",
        "formatted_address": "10 Downing Street, London, SW1A 2AA, United Kingdom"
      },
      "verified": true,
      "last_checked_at": "2026-11-14T04:35:10.452Z",
      "latency_ms": 5,
      "uptime_30d": 87
    },
    {
      "method": "GET",
      "path": "/geocode?address={address}",
      "url": "https://apistead.qd.je/api/v1/geocode?address={address}",
      "price_usdc": 0.001,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Forward geocode an address.",
      "example_request": "GET https://apistead.qd.je/api/v1/geocode?address=10%20Downing%20Street%20London",
      "example_response": {
        "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"
      },
      "verified": true,
      "last_checked_at": "2026-11-14T04:35:10.444Z",
      "latency_ms": 4,
      "uptime_30d": 87
    }
  ],
  "changelog": [
    {
      "version": "1.0.0",
      "title": "Initial verified release",
      "body": "The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.",
      "type": "release",
      "author": "APIStead Labs",
      "published_at": "2026-11-11T16:54:23.733Z"
    }
  ],
  "generated_at": "2026-11-14T04:43:16.535Z"
}