# CDC PLACES local health estimates (data.cdc.gov) · Search

Get 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.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `data-cdc-gov/prevalence/search`
- Page: https://spiral.ai/tools/alexandria/data-cdc-gov/prevalence/search

## Pricing

$0.00873 per call.

## Limits

- 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 | Allowed | 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 (`Harris`, `Chicago`); for counties a trailing County, Parish or Borough is optional (`Harris County`). County and place level only, with `state`. A name that matches no location in the release is not_found. |
| `sort` | one of | value_desc, value_asc, location | value_desc | `value_desc` (default, highest first), `value_asc` or `location` (by location code). Suppressed values sort last; ties go by location code. |
| `level` | one of | county, place, tract, zcta | county | Geography: `county` (default), `place` (cities, towns and census designated places), `tract` (census tracts; needs `state`, `county_fips` or `locations`) or `zcta` (ZIP Code Tabulation Areas; no state, so select them by `locations` or page through all). |
| `limit` | number | 1 to 1000 | 100 | Locations per page. `total_count` and `summary` cover every match. |
| `state` | text |  | — | USPS code of one of the 50 states or DC (`TX`). Not at zcta level, where CDC gives no state. Needed with `name`, and at tract level unless `county_fips` or `locations` is given. Pattern: ^[A-Za-z]{2}$. |
| `offset` | number | 0 to 100000 | 0 | Matches to skip: `next_offset` of the previous page. |
| `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 (`48201`), 7-digit place FIPS (`1714000`), 11-digit tract FIPS (`48201100001`) or 5-digit ZCTA (`77002`). County, place and tract codes must start with a state's FIPS code (and `state`'s, when given). Codes without an estimate are left out with a warning; when none of them exists for any measure, the call is not_found. |
| `value_type` | one of | crude, age_adjusted | crude | `crude` (default): the share of the location's adults. `age_adjusted`: standardized to the 2000 US population so locations with different age structures compare; county and place level only, and estimated adults are not derived from it. |
| `county_fips` | text |  | — | 5-digit county FIPS code (`48201`): the census tracts of that county. Tract level only. Pattern: ^[0-9]{5}$. |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=data-cdc-gov%2Fprevalence%2Fsearch

## Common questions

### CDC PLACES local health estimates (data.cdc.gov) · Search

**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.

