get_county_measures
Get all CDC PLACES health measures for a county.
Returns up to 36 measures including health outcomes (diabetes, obesity,
heart disease, etc.), health behaviors (smoking, binge drinking), preventive
services (checkups, screenings), and health status indicators.
Args:
county_fips: 5-digit county FIPS code (e.g. '53033' for King County, WA).
Must be a string, not an integer.
year: Optional release year to filter by. Omit for the most recent data.
get_tract_measures
Get all CDC PLACES health measures for a census tract.
Returns tract-level estimates for health outcomes, behaviors, preventive
services, and health status indicators. Tract-level data uses small area
estimation and may have wider confidence intervals than county data.
Args:
tract_fips: 11-digit census tract FIPS code (e.g. '53033005300').
Must be a string, not an integer.
year: Optional release year to filter by. Omit for the most recent data.
get_measure_by_state
Get one CDC PLACES measure for all counties in a state.
Useful for comparing a specific health metric (e.g. DIABETES, OBESITY)
across all counties within a state. Returns the most recent data year.
Args:
state_abbr: Two-letter state abbreviation (e.g. 'WA', 'CA').
measure_id: PLACES measure ID (e.g. 'DIABETES', 'OBESITY', 'BPHIGH').
Use search_measures to find valid IDs.
search_measures
Search available CDC PLACES measures by name or category.
Returns matching measure IDs, names, and categories. Use this to find
the correct measure_id for other tools.
Categories: Health Outcomes, Health Behaviors, Prevention, Health Status.
Args:
keyword: Search term (e.g. 'diabetes', 'smoking', 'prevention', 'heart').
compare_counties
Compare specific CDC PLACES measures across multiple counties.
Returns a side-by-side comparison of selected health measures for the
given counties. Useful for benchmarking one county against peers.
Args:
fips_list: List of 5-digit county FIPS codes (e.g. ['53033', '53053', '06037']).
Maximum 10 counties per request.
measures: List of PLACES measure IDs to compare (e.g. ['DIABETES', 'OBESITY']).
Maximum 10 measures per request.