US Census ACS State Profiles

Wide-format state-level profiles from the US Census Bureau American Community Survey (ACS) 1-Year estimates. One row per state per year covering demographics (population, age, race/ethnicity), income (median household income, per capita income), poverty, housing (home values, rents, homeownership), and educational attainment. Covers all 50 states and DC, 2005–2023 (2020 excluded — survey suspended due to COVID-19).

demographics country/usa demographics/country/usa/acs-state-profiles census acs demographics income housing education usa state annual key-metrics

Catalog

Browse and search all available datasets.

Catalog — browse all datasets
GET /api/catalog — catalog in JSON
GET /api/catalog?q=… — search the catalog

Dataset API

Endpoints for this dataset — schema, filter values, preview, and querying.

GET /api/datasets/acs-state-profiles — schema, filters, and pricing
GET /api/datasets/acs-state-profiles/sample — free sample (100 rows)
GET /api/datasets/acs-state-profiles/members/{col} — valid values for a filterable column
GET /api/datasets/acs-state-profiles/query — query with filters (API key required)

Purchase

Add balance or buy access to start querying.

POST /api/checkout/x402 — agents: add balance via x402 (USDC)
Sign in at /account — humans: add balance via Stripe (card, Apple Pay, bank transfer)
POST /api/ap2/intent → /api/ap2/purchase — agents: AP2 mandate-based payment

Source

Name: US Census Bureau — American Community Survey
URL: https://www.census.gov/programs-surveys/acs
License: Public Domain

Size and Format

Rows: 780
Columns: 17
Size (bytes): 41,413
Formats: parquet, csv

Pricing

Per query (USD): 0.0100 USD
Max rows per query: 1000
Free: No
Free sample: Yes

Temporal Coverage

end: 2023
start: 2005
frequency: annual

Geographic Coverage

level: state
coding: FIPS
region: United States (50 states + DC)

Query Filters

Columns you can use as query params in GET /api/datasets/acs-state-profiles/query.

state_fips Members (JSON)
state_name Members (JSON)
year Members (JSON)

Schema (Columns)

Column	Type	Description	Filterable
`state_fips`	string	2-digit FIPS code for the state (e.g. '06' for California, '48' for Texas)	Yes
`state_name`	string	Full state name (e.g. 'California', 'Texas')	Yes
`year`	integer	Survey year (ACS 1-Year; 2020 excluded — survey suspended due to COVID-19)	Yes
`population`	integer	Total resident population	No
`median_age`	float	Median age of the population	No
`pct_white`	float	Population identifying as White alone, as % of total population	No
`pct_black`	float	Population identifying as Black or African American alone, as % of total population	No
`pct_asian`	float	Population identifying as Asian alone, as % of total population	No
`pct_hispanic`	float	Population identifying as Hispanic or Latino (any race), as % of total population	No
`median_household_income`	integer	Median household income in the past 12 months (inflation-adjusted dollars for that survey year)	No
`per_capita_income`	integer	Per capita income in the past 12 months (inflation-adjusted dollars for that survey year)	No
`poverty_rate`	float	Percentage of the population with income below the federal poverty level	No
`median_home_value`	integer	Median value of owner-occupied housing units (dollars)	No
`median_gross_rent`	integer	Median gross rent for renter-occupied units (dollars per month)	No
`homeownership_rate`	float	Percentage of occupied housing units that are owner-occupied	No
`pct_hs_or_higher`	float	Percentage of population 25+ with a high school diploma or higher	No
`pct_bachelors_or_higher`	float	Percentage of population 25+ with a bachelor's degree or higher	No

← Back to catalog