ACS Data Tool
acs_data_toolRead-onlyIdempotent
Retrieve American Community Survey demographic and economic data, including population, income, employment, education, and housing statistics, for any U.S. geography and year.
Instructions
Retrieve demographic and economic data from the American Community Survey (ACS). Use this to get population statistics, household income, employment, education, housing data, and more. Supports both 1-year and 5-year estimates at various geographic levels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Year for ACS data (e.g., 2022). Use the most recent year available. | |
| dataset | No | ACS dataset: "acs1" (1-year estimates, more current but less detailed) or "acs5" (5-year estimates, more detailed and stable) | acs5 |
| variables | Yes | Census variable codes to retrieve (e.g., ["B01001_001E", "B19013_001E"]). B01001_001E is total population, B19013_001E is median household income. | |
| geography | No | Geographic level for data aggregation | state |
| state | No | State FIPS code (required for county, tract, place geographies) | |
| county | No | County FIPS code (required for tract geography) |