# US Census ACS 5-Year Demographics by ZIP Code

> US Census ACS 5-Year Demographics by ZIP Code is a paid API for AI agents from x402-seller.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns US Census Bureau ACS 5-year estimates (population, median household income, median age, housing units) for a given 5-digit ZIP code via ZCTA mapping.

## Facts

- Endpoint: GET https://x402-seller.onrender.com/census/demographics
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-census-acs-5-year-demographics-by-zip-code-f4060e70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GpPaRf8buKHwEcbiky8Ff

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 us-census-acs-5-year-demographics-by-zip-code-f4060e70
```

Example prompt: Can you pull up the census demographics for ZIP code 10001 — I want to see the population, median household income, median age, and total housing units for that area?

## When to prefer this

Use this endpoint when you need official US Census Bureau demographic estimates (population, income, age, housing) for a specific ZIP code and can tolerate a rolling 5-year survey window rather than real-time data. Prefer this over third-party demographic APIs when authoritative government sourcing is required. Not suitable for ZIPs that are PO-box-only or very recently created.

## Known failure modes

- 404 if ZIP code has no matching ZCTA (PO-box-only ZIPs, very new ZIPs)
- Invalid or non-existent ZIP code returns an error
- Missing required 'zip' query parameter causes a bad request error
- Census API upstream outage may cause service unavailability
- Data is not real-time — reflects a rolling 5-year survey window, potentially lagging current conditions

## How this service works

US Census Bureau American Community Survey (ACS) 5-Year estimates for a ZIP code: total population, median household income, median age, and total housing units. ZIP codes map to Census ZCTAs (Census-drawn approximations); some ZIPs (PO-box-only or very new) have no ZCTA match and return 404. Reflects a rolling 5-year survey window, not real-time.

## Output

Returns a JSON object with the ZIP code, matched ZCTA code, geographic name, ACS vintage year, total population, median household income, median age, and total housing units. Values may be null for some fields if the Census did not collect enough data. Returns 404 if the ZIP has no corresponding ZCTA (e.g. PO-box-only or very new ZIPs).

## 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": [
      "zip"
     ],
     "properties": {
      "zip": {
       "type": "string",
       "description": "5-digit US ZIP code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "zip": {
       "type": "string"
      },
      "name": {
       "type": [
        "string",
        "null"
       ]
      },
      "zcta": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "vintage": {
       "type": "string"
      },
      "medianAge": {
       "type": [
        "number",
        "null"
       ]
      },
      "population": {
       "type": [
        "number",
        "null"
       ]
      },
      "housingUnits": {
       "type": [
        "number",
        "null"
       ]
      },
      "medianHouseholdIncome": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-census-acs-5-year-demographics-by-zip-code-f4060e70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-seller.onrender.com](https://www.zero.xyz/host/x402-seller.onrender.com/llms.txt)