# SiteCheck US Geocode

> SiteCheck US Geocode is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-19).

Geocodes a US address string to latitude/longitude coordinates with Census tract, county FIPS, and state data using the US Census Bureau geocoder.

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/us-geocode?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-us-geocode-52974019
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UoKDmj6scSw3KQClNU8PX

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 sitecheck-us-geocode-52974019
```

Example prompt: Can you geocode '1600 Pennsylvania Ave NW, Washington, DC 20500' and give me the latitude, longitude, county FIPS, and census tract?

## When to prefer this

Choose this endpoint when you need authoritative US address geocoding tied to Census Bureau geographies (tract, county FIPS, state FIPS) at very low cost ($0.001/call). Ideal for compliance workflows, demographic enrichment, or any use case requiring official Census identifiers alongside coordinates. Prefer over generic geocoding APIs when Census tract or FIPS codes are required outputs.

## Known failure modes

- Address not found or unrecognized — Census geocoder returns no match
- Malformed or non-US address input — may return null coordinates
- Missing required 'address' query parameter — request fails validation
- Census Bureau geocoder upstream outage — service temporarily unavailable
- Ambiguous address with multiple possible matches — only top match returned

## How this service works

Geocodes a one-line US address with the US Census Bureau: matched address, coordinates, county, state, census tract and block group. Addresses that do not match answer 404 (not charged). Public domain data.

## Output

Returns a JSON object with latitude, longitude, matched address string, state name, county name, state FIPS code, county FIPS code, census tract, block group, the original query, the Census Bureau source URL, and a timestamp of when the lookup was performed.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "One line, US address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 38.898702605245,
  "lon": -77.035189204737,
  "query": "1600 Pennsylvania Ave NW, Washington, DC 20500",
  "state": "District of Columbia",
  "county": "District of Columbia",
  "source": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress",
  "checkedAt": "2026-10-14T07:00:44.072Z",
  "stateFips": "11",
  "blockGroup": null,
  "countyFips": "11001",
  "attribution": "US Census Bureau (public domain)",
  "censusTract": "980000",
  "matchedAddress": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-us-geocode-52974019/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)
