get_county_svi
Get CDC Social Vulnerability Index data for counties in a state.
Returns overall SVI percentile ranking and all four theme breakdowns
(socioeconomic status, household composition/disability, minority
status/language, housing type/transportation) plus key indicator
estimates for each county.
SVI values range 0-1 (percentile ranking); higher = more vulnerable.
Args:
state: Two-letter US state abbreviation (e.g. 'WA', 'CA').
county_fips: Optional 5-digit county FIPS code to get a single county.
year: SVI data year (default 2022, currently only 2022 available).
get_tract_svi
Get tract-level CDC Social Vulnerability Index data within a county.
Returns overall SVI and all four theme percentile rankings for each
census tract in the specified county. Useful for identifying
sub-county areas of high vulnerability.
Args:
state: Two-letter US state abbreviation (e.g. 'WA', 'CA').
county_fips: 5-digit county FIPS code (e.g. '53033' for King County, WA).
year: SVI data year (default 2022, currently only 2022 available).
limit: Maximum number of tracts to return (default 50, max 500).
get_most_vulnerable
Get the most vulnerable counties in a state ranked by SVI score.
Returns counties sorted by highest SVI percentile ranking for the
specified theme. Useful for identifying priority areas for grants
and community health interventions.
Args:
state: Two-letter US state abbreviation (e.g. 'WA', 'CA').
theme: SVI theme to rank by. Options: 'overall', 'socioeconomic',
'household' (composition/disability), 'minority' (status/language),
'housing' (type/transportation). Default is 'overall'.
limit: Number of counties to return (default 20, max 100).
compare_svi
Compare SVI data across multiple counties.
Returns side-by-side SVI percentile rankings and key indicators for
the specified counties. Useful for comparing vulnerability across
service areas or peer counties.
Args:
fips_codes: Comma-separated 5-digit county FIPS codes (e.g. '53033,53053,53061').
year: SVI data year (default 2022, currently only 2022 available).