CDC PLACES local health estimates (data.cdc.gov) · Search
data-cdc-gov/prevalence/searchGet health and medical data with CDC PLACES local health estimates (data.cdc.gov) · Search from Alexandria through one Spiral API key. Search. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
measure required | one of ACCESS2, ARTHRITIS, BINGE, BPHIGH, BPMED, CANCER, CASTHMA, CHD, CHECKUP, CHOLSCREEN, COGNITION, COLON_SCREEN, COPD, CSMOKING, DENTAL, DEPRESSION, DIABETES, DISABILITY, EMOTIONSPT, FOODINSECU, FOODSTAMP, GHLTH, HEARING, HIGHCHOL, HOUSINSECU, INDEPLIVE, LACKTRPT, LONELINESS, LPA, MAMMOUSE, MHLTH, MOBILITY, OBESITY, PHLTH, SELFCARE, SHUTUTILITY, SLEEP, STROKE, TEETHLOST, VISION, CERVICAL, COREM, COREW, KIDNEY, ISOLATION | — | PLACES measure id. Health outcomes: ARTHRITIS, BPHIGH (high blood pressure), CANCER (cancer other than skin, or melanoma), CASTHMA (current asthma), CHD (coronary heart disease), COPD, DEPRESSION, DIABETES (diagnosed), HIGHCHOL (high cholesterol among adults ever screened), OBESITY, STROKE, TEETHLOST (all teeth lost, adults 65 and older). Prevention: ACCESS2 (no health insurance, ages 18-64), BPMED (taking blood pressure medicine, among adults with high blood pressure), CHECKUP, CHOLSCREEN, COLON_SCREEN (ages 45-75), DENTAL, MAMMOUSE (women 50-74). Risk behaviors: BINGE, CSMOKING, LPA (no leisure-time physical activity), SLEEP (short sleep). Health status: GHLTH (fair or poor health), MHLTH (frequent mental distress), PHLTH (frequent physical distress). Disabilities (2023 release on): DISABILITY (any), COGNITION, HEARING, INDEPLIVE, MOBILITY, SELFCARE, VISION. Social needs (2024 release on): EMOTIONSPT, FOODINSECU, FOODSTAMP, HOUSINSECU, LACKTRPT, SHUTUTILITY; LONELINESS (2025 on); ISOLATION (2024 only). Releases up to 2023 only: CERVICAL, COREM, COREW, KIDNEY (chronic kidney disease). A measure the chosen release lacks is invalid_input naming the release's measures. |
name | text | — | County or place name, matched case-insensitively and exactly as CDC writes it ( |
sort | one of value_desc, value_asc, location | value_desc |
|
level | one of county, place, tract, zcta | county | Geography: |
limit | number 1 to 1000 | 100 | Locations per page. |
state | text | — | USPS code of one of the 50 states or DC ( |
offset | number 0 to 100000 | 0 | Matches to skip: |
release | number 2020 to 2100 | — | PLACES release year. Default: the latest release at the chosen level. Releases before 2024 have no adult population; the 2020 county release lacks location codes and is refused. |
locations | list | — | 1 to 100 location codes at the chosen level: 5-digit county FIPS ( |
value_type | one of crude, age_adjusted | crude |
|
county_fips | text | — | 5-digit county FIPS code ( |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "data-cdc-gov/prevalence/search",
"input": {
"measure": "ACCESS2"
}
}'Frequently asked questions
How much does CDC PLACES local health estimates (data.cdc.gov) · Search cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use CDC PLACES local health estimates (data.cdc.gov) · Search through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "data-cdc-gov/prevalence/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use CDC PLACES local health estimates (data.cdc.gov) · Search?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use CDC PLACES local health estimates (data.cdc.gov) · Search?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.