Skip to main content
Skip to content
API productFreeUnited States

US Census Intelligence API

ACS demographics, income, housing and employment by ZIP, county and state.

500/daykeyless free tier
ZIP · county · stategeographies
v1.1.6production contract

Overview

Normalized American Community Survey intelligence by ZIP, county and state, with a strict percentage-points contract and explicit missing-value handling. A keyless free tier answers 500 requests a day; direct plans are issued by our team on request. PropData Builder and above also include census-tract Community Intelligence inside the property API.

API explorer

Endpoints, code and real responses

curl "https://propdata-census-api.sales-fd3.workers.dev/v1/census?zip=78701"
Keyless production route · real response
Example response200captured from production 2026-10-28 · arrays and long strings trimmed
{
  "quota": {
    "used": 7,
    "limit": 500,
    "unlimited": false,
    "resets_at": "2026-10-29T00:00:00.000Z",
    "tier": "free"
  },
  "cached": true,
  "source": "census_acs",
  "zip": "78701",
  "demographics": {
    "total_population": 11114,
    "median_age": 41.5,
    "population_density": null
  },
  "income": {
    "median_household_income": 154867,
    "per_capita_income": 137841,
    "poverty_rate_pct": 13.3,
    "population_below_poverty": 1463
  },
  "_upgrade_note": "Upgrade to BASIC ($4.99/mo) for education, housing, employment, commute, and race/ethnicity data.",
  "data_year": 2023,
  "data_source": "Census ACS 5-Year Estimates",
  "acs_survey": {
    "source": "US Census Bureau ACS 5-year",
    "acs_vintage": "2019-2023",
    "survey_end_year": 2023,
    "geography": "zcta5"
  },
  "data_quality": {
    "contract": "acs_missing_value_v1",
    "coverage": "complete",
    "suppressed_fields": [],
    "null_fields": [
      "demographics.population_density"
    ],
    "null_semantics": "null means the Census Bureau published no usable estimate for this geography (missing, suppressed, or not computable). Census annotation sentinel codes are n…"
  },
  "percentage_contract": {
    "version": "percentage_points_v2",
    "fields": "*_pct",
    "unit": "percentage_points",
    "scale": "0_to_100",
    "ratio_fields": "*_ratio",
    "ratio_unit": "ratio",
    "ratio_scale": "0_to_1",
    "interpretation": "Values are already percentages. 0.5 means 0.5%, not 50%. Do not multiply by 100.",
    "ratio_conversion": "Use the matching *_ratio field when a client formatter multiplies by 100."
  },
  "acs_missing_value_contract": {
    "version": "acs_missing_value_v1",
    "failure_mode": "fail_closed_to_null",
    "applies_to": "every ACS-derived numeric field (estimates, counts, medians, and derived percentages)",
    "interpretation": "null means the Census Bureau published no usable estimate for this geography (missing, suppressed, or not computable). Census annotation sentinel codes are n…",
    "signed_fields": [
      "income.per_capita_income"
    ],
    "suppression_reasons": [
      "acs_insufficient_sample_cases",
      "acs_not_applicable",
      "… 7 more"
    ]
  },
  "generated_at": "2026-10-28T12:34:30.377Z"
}

Live status

What production reports right now

Each check calls this product’s own health or source endpoint from the store server and reports what it returns.