Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaHealthAvailable now

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

uscs-cdc-gov/cancer-statistics/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.

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

FieldKindDefaultDescription
breakdown requiredone 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).

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

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

sitetext—

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.

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

yeartext—

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})?$.

eventone of
incidence, mortality
incidence

incidence: new cases (cancer registries); mortality: cancer deaths (death certificates). Not prevalence.

limitnumber
1 to 1000
100

Rows returned after sorting; total_count has them all.

statetext—

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_yearnumber
1999 to 2100
—

Last single year of a trend; with from_year (default 1999).

from_yearnumber
1999 to 2100
—

First single year of a trend; with to_year (default the latest). Not for counties.

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

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

Frequently asked questions

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.