location.us.geocode

US Address Geocoding

Coordinates for a one-line US street address from the Census Bureau geocoder, with the standardised match. Interpolated along street ranges, not rooftop positions.

Example answer

Ask

Did the Census Bureau recognise this US address at all?

GET /v1/locations/us/geocode?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500&limit=1

Eckari

{
  "query": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
  },
  "items": [
    {
      "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
      "lat": 38.898699,
      "lon": -77.035188,
      "precision": "tiger_interpolated",
      "tiger_line_id": "76225813",
      "side": "L",
      "address_components": {
        "from_address": "1600",
        "to_address": "1648",
        "street_name": "PENNSYLVANIA",
        "pre_type": null,
        "pre_direction": null,
        "suffix_type": "AVE",
        "suffix_direction": "NW",
        "city": "WASHINGTON",
        "state": "DC",
        "zip": "20500"
      }
    }
  ],
  "page": {
    "limit": 1,
    "offset": 0,
    "returned": 1,
    "total": 1,
    "has_more": false,
    "next_offset": null
  },
  "benchmark": "Public_AR_Current"
}

Source: US Census Bureau
Freshness: Live
Price: $0.003

Version: 3.0.0
Transport: HTTP / MCP
Coverage: US

Use this when

Convert this US street address to latitude and longitude.
You need coordinates for a US address before looking up census geographies.
You want a standardised, parsed form of a messy US address string.
You are batching US addresses to approximate map positions.
Did the Census Bureau recognise this US address at all?

Don't use this when

You need rooftop or parcel-level precision — Census coordinates are TIGER address-range interpolations.
You need USPS deliverability or ZIP validation — this is not a USPS service.
The address is outside the US and Puerto Rico — no match will be returned.
You already have coordinates and want census geographies — use location.us.geographies.
You need routing, driving directions or map tiles.

If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the US Census Bureau Geocoding Services API record.

Input

addressstringrequired

One-line US street address including city and state, e.g. "1600 Pennsylvania Ave NW, Washington, DC 20500".

limitintegerdefault 5

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.

offsetintegerdefault 0

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.

What the result means

queryobject

The resolved input, echoed so a batched caller can match answers to requests.

itemsarray

Candidate matches in the Census Bureau's own order (best first), for the requested page. Eckari applies no re-ranking. An empty array with page.total 0 means the Census Bureau recognised no address - a valid answer, not an error.

pageobject

Canonical paging block over the candidate list the Census Bureau returned for this address.

benchmarkstring, null

Census Bureau address-range benchmark used for the match (Public_AR_Current).

Provenance

Source: US Census Bureau
Freshness: Live · read at request time, not cached
Region: US

Access

Over MCP: location_us_geocode
Over HTTP: GET https://api.eckari.com/v1/locations/us/geocode
Price: $0.003 per call over x402. Account access $0.002 when that rail opens.