UnifyAPI
← Back to catalog

cdc.query

mock data$0.001 / call

Query CDC Dataset

Query a specific CDC dataset using SoQL filters — filter by state, year, age group, condition. Returns structured rows with column names. Supports WHERE, SELECT, ORDER, GROUP BY. Use cdc.datasets to find dataset IDs first (US Gov, Socrata SODA API)

Healthprovider: Cdc#cdc#health

Input schema

group

Group by columns for aggregation (e.g. "state" with select "state, SUM(deaths)")

string
limit

Max rows to return (1-1000, default 100)

integer
order

Sort order (e.g. "year DESC", "deaths DESC"). Default: dataset default order.

string
where

SoQL WHERE clause filter (e.g. "state='CA'", "year > 2020", "age_group='65+'")

string
select

Columns to return, comma-separated (e.g. "state, year, deaths"). Default: all columns.

string
dataset_idrequired

CDC dataset ID in xxxx-xxxx format (e.g. "9bhg-hcku" for COVID deaths). Use cdc.datasets to find IDs.

string

Call via REST

curl -X POST https://unifyapi.pro/api/call/cdc.query \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"group":"<group>","limit":0,"order":"<order>","where":"<where>","select":"<select>","dataset_id":"<dataset_id>"}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.