# Eckari US Address Geocoder

> Eckari US Address Geocoder is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Converts a one-line US street address to latitude/longitude coordinates using the US Census Bureau Geocoder, returning standardized address, parsed components, and TIGER/Line segment data.

## Facts

- Endpoint: GET https://api.eckari.com/v1/locations/us/geocode?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eckari-us-address-geocoder-285eb5ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QapK8S_seIJ5sJfgSmxHr

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 eckari-us-address-geocoder-285eb5ae
```

Example prompt: Can you get the latitude and longitude for 350 Fifth Avenue, New York, NY 10118? I need the Census Bureau geocoded coordinates with the standardized matched address and parsed components.

## When to prefer this

Choose this endpoint when you need to geocode US street addresses using authoritative Census Bureau data and can tolerate interpolated (not rooftop) precision. Ideal for bulk or automated workflows where cost-per-call matters ($0.003 USDC) and where TIGER/Line segment metadata or parsed address components are useful. Prefer over proprietary geocoders when open government data provenance is required or when no API key management is desired. Not suitable for non-US addresses or when rooftop/parcel-level precision is required.

## Known failure modes

- No match found — Census Bureau returns zero candidates for unrecognized or malformed addresses (normal, not an error; items array is empty)
- Address outside the US — endpoint only covers US addresses; non-US input will return no match
- Address too short or vague (under 5 characters) — rejected by input validation before upstream call
- Ambiguous address with multiple candidates — all candidates returned up to the limit; agent should use pagination to review all matches
- Rate limit or payment failure — 402 response if x402 payment not completed

## How this service works

Convert a one-line US street address into coordinates using the US Census Bureau Geocoder. Returns the standardised matched address, latitude and longitude to 6 decimal places, the TIGER/Line segment and parsed address components. Coordinates are interpolated along street address ranges, not rooftop or parcel positions. No match is a normal answer, not an error. Use when: Convert this US street address to latitude and longitude.

## Output

Returns a paginated list of candidate matches, each containing: latitude and longitude (6 decimal places, TIGER interpolated), standardized matched address string, parsed address components (street name, number range, direction, suffix, city, state, ZIP), TIGER/Line segment ID, side of street, and precision type. Also includes query echo, benchmark used, and pagination metadata (total, returned, has_more, next_offset).

## 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": {
      "limit": {
       "type": "integer",
       "default": 5,
       "maximum": 10,
       "minimum": 1,
       "description": "Maximum number of candidate matches to return, in the Census Bureau's own order. page.total always reports how many the Census Bureau returned in total, so a low limit never hides an ambiguous address."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "description": "Zero-based index of the first candidate to return. The Census Bureau returns every match in one response, so paging is applied by Eckari over that set - pass page.next_offset to walk the remaining candidates without a second upstream lookup."
      },
      "address": {
       "type": "string",
       "maxLength": 200,
       "minLength": 5,
       "description": "One-line US street address including city and state, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\"."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "page": {
    "limit": 1,
    "total": 1,
    "offset": 0,
    "has_more": false,
    "returned": 1,
    "next_offset": null
   },
   "items": [
    {
     "lat": 38.898699,
     "lon": -77.035188,
     "side": "L",
     "precision": "tiger_interpolated",
     "tiger_line_id": "76225813",
     "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
     "address_components": {
      "zip": "20500",
      "city": "WASHINGTON",
      "state": "DC",
      "pre_type": null,
      "to_address": "1648",
      "street_name": "PENNSYLVANIA",
      "suffix_type": "AVE",
      "from_address": "1600",
      "pre_direction": null,
      "suffix_direction": "NW"
     }
    }
   ],
   "query": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
   },
   "benchmark": "Public_AR_Current"
  },
  "meta": {
   "source": "census_geocoder",
   "version": "3.0.0",
   "freshness": "live",
   "capability": "location.us.geocode"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-us-address-geocoder-285eb5ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)