# U.S. Cancer Statistics (CDC and NCI) · Search

Get health and medical data with U.S. Cancer Statistics (CDC and NCI) · Search from Alexandria through one Spiral API key. For "incidence of pancreatic cancer by state", "pancreatic cancer incidence in Texas counties", "US lung cancer incidence by age group", "breast cancer mortality trend 1999-2024 in California" or "which cancer sites have the highest incidence nationally". 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` / `uscs-cdc-gov/cancer-statistics/search`
- Page: https://spiral.ai/tools/alexandria/uscs-cdc-gov/cancer-statistics/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 |
| --- | --- | --- | --- | --- |
| `breakdown` (required) | one of | state, county, age, national | — | `state`: the 50 states and DC by year (BYAREA); `county`: counties for the latest 5-year period (BYAREA_COUNTY); `age`: the U.S. by 19 age groups and year, age-specific rates (BYAGE); `national`: the U.S. by year for 83 detailed sites (BYSITE). |
| `sex` | one of | all, male, female | — | Default `all` (USCS `Male and Female`). A sex-specific site (Prostate, Cervix, Ovary, Female Breast, Male Breast and similar) is read under its own sex; the other sex fails. |
| `race` | one of | all, white, black, american_indian_alaska_native, asian_pacific_islander, asian, native_hawaiian_pacific_islander, hispanic | all | Race and ethnicity, non-Hispanic except `hispanic`. Incidence uses bridged race (`asian_pacific_islander`); deaths from 2018 and county rows use single race, where `asian` and `native_hawaiian_pacific_islander` exist; a race the table lacks for the filters is an empty result with a warning. |
| `site` | text |  | — | Cancer site, default `All Cancer Sites Combined`: a USCS name matched case-insensitively (`Pancreas`, `Lung and Bronchus`, `Non-Hodgkin Lymphoma`), an everyday name (`pancreatic`, `lung`, `breast` for Female Breast, `colorectal`, `melanoma`, `leukemia`, `uterine`), or the one site having every word given; `all` for every site of the table. State, county and age tables have 27 to 30 sites, the national table 83. An unknown name fails and lists the table's sites. |
| `sort` | one of | rate_desc, rate_asc, count_desc | — | Order by rate or count; rows without the value come last. Default: by area, age group, site and year. |
| `year` | text |  | — | One year (`2023`) or a 5-year period as USCS writes it (`2019-2023`). Default: the latest single year the table has for the event (2023 for incidence, 2024 for deaths in the 1999-2023 release); counties have only their 5-year period. Not with `from_year`/`to_year`. Pattern: ^\d{4}(-\d{4})?$. |
| `event` | one of | incidence, mortality | incidence | `incidence`: new cases (cancer registries); `mortality`: cancer deaths (death certificates). Not prevalence. |
| `limit` | number | 1 to 1000 | 100 | Rows returned after sorting; `total_count` has them all. |
| `state` | text |  | — | One state or a list, by name (`Texas`) or USPS code (`TX`), for breakdowns `state` and `county`; omitted means all 50 states and DC. The tables are grouped by state, so a few states read less of the archive. |
| `to_year` | number | 1999 to 2100 | — | Last single year of a trend; with `from_year` (default 1999). |
| `from_year` | number | 1999 to 2100 | — | First single year of a trend; with `to_year` (default the latest). Not for counties. |
| `include_combined_sites` | true or false |  | — | With `site: all`: false drops sites that group other sites of the same table (All Cancer Sites Combined, Digestive System, Male and Female Breast, Lymphomas and so on), so a ranking lists single sites only. |

## 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": "uscs-cdc-gov/cancer-statistics/search",
    "input": {
      "breakdown": "state"
    }
  }'
```

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

## Common questions

### U.S. Cancer Statistics (CDC and NCI) · Search

**How much does U.S. Cancer Statistics (CDC and NCI) · 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 U.S. Cancer Statistics (CDC and NCI) · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "uscs-cdc-gov/cancer-statistics/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 U.S. Cancer Statistics (CDC and NCI) · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use U.S. Cancer Statistics (CDC and NCI) · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

