# API Acre US Address Geocoder

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

Geocodes a single US structural address to Census MAF/TIGER coordinates with optional state, county, tract, block, and congressional geography enrichment.

## Facts

- Endpoint: POST https://apiacre.com/v1/data/us-address-geocode?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-us-address-geocoder-04d38907
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gAw40obhodz0A0vW7kATE

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-acre-us-address-geocoder-04d38907 -d '<json body>'
```

Example prompt: Can you geocode the address 1600 Pennsylvania Ave NW, Washington, DC 20500 and include the census tract, county, and state geography?

## When to prefer this

Choose this endpoint when you need authoritative US Census-sourced geocoding with official GEOID-tagged census geographies (state, county, tract, block) for a single US, Puerto Rico, or US Island Area structural address, especially when source attribution, MAF/TIGER lineage, and explicit interpolation limitations are required for compliance or research purposes. Prefer it over commercial geocoders when Census TIGER coordinates and census tract/county identifiers are specifically needed.

## Known failure modes

- Address not found in MAF/TIGER database — matched:false returned with empty matches array
- Ambiguous address matches multiple TIGER ranges — ambiguous:true with multiple candidates
- Address outside coverage (non-US territory) — no match or error response
- Malformed address string causes geocoder parse failure — matched:false
- Census upstream geocoder unavailable — service error or degraded response
- includeGeographies requested but geography vintage unavailable — geographies.available:false

## How this service works

Geocode one structural address in the United States, Puerto Rico, or U.S. Island Areas with normalized U.S. Census MAF/TIGER coordinates, optional bounded state/county/tract/block/congressional geography, exact source attribution, and explicit range-interpolation limits.

## Output

Returns a JSON object with the matched normalized address, latitude/longitude coordinates derived from MAF/TIGER address range interpolation, TIGER line ID and side, optional census geographies (state, county, tract with GEOIDs and names), address range components (fromAddress, toAddress, directional qualifiers), benchmark and vintage metadata, match count, ambiguity flag, data source attribution including Census terms URL, and a list of explicit range-interpolation limitations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string"
  },
  "include_geographies": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "address": "4600 Silver Hill Rd, Washington, DC 20233",
    "includeGeographies": true
   },
   "source": {
    "dataset": "Census Geocoding Services using MAF/TIGER address ranges",
    "provider": "U.S. Census Bureau",
    "endpointUrl": "https://geocoding.geo.census.gov/geocoder/geographies/one...",
    "documentationUrl": "https://geocoding.geo.census.gov/geocoder/Geocoding_Servi..."
   },
   "matched": true,
   "matches": [
    {
     "tigerLine": {
      "id": "657091557",
      "side": "L"
     },
     "coordinates": {
      "latitude": 38.845053106269,
      "longitude": -76.928365658124
     },
     "matchedAddress": "4600 SILVER HILL RD, WASHINGTON, DC, 20233",
     "addressComponents": {
      "toAddress": "4700",
      "fromAddress": "4600",
      "preDirection": null,
      "preQualifier": null
     }
    }
   ],
   "vintage": {
    "id": "4",
    "name": "Current_Current",
    "isDefault": true,
    "description": "Current Vintage - Current Benchmark"
   },
   "ambiguous": false,
   "benchmark": {
    "id": "4",
    "name": "Public_AR_Current",
    "isDefault": true,
    "description": "Public Address Ranges - Current Benchmark"
   },
   "matchCount": 1,
   "limitations": [
    "Coordinates are calculated along a MAF/TIGER address rang...",
    "Coverage is limited to structural addresses in the United...",
    "No match does not prove that an address is nonexistent, c...",
    "The caller-supplied address is sent to the Census Geocode...",
    "Current benchmark and geography-vintage data can change, ..."
   ],
   "retrievedAt": "2026-08-18T05:35:00+00:00",
   "matchesTruncated": false
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "title": "Global weather forecast",
     "method": "POST",
     "reason": "Use the selected Census coordinates for a separately auth...",
     "service": "data.us-weather-forecast"
    }
   ]
  },
  "service": "data.us-address-geocode",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

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