Get started

CDC open data in Duaer

In Duaer: CDC open datasets on data.cdc.gov: find datasets by words, then read rows from one dataset, such as influenza deaths or vaccination coverage. One successful search uses 1 credit.

What you get

Duaer CDC open data works in two steps: search the data.cdc.gov catalog for datasets, then read rows from one dataset by its id.

Pick Duaer Data → CDC open data in the node creator, or open the data market. Related: WHO health statistics, US hospitals (CMS).

When to use it

Find the CDC dataset for a disease or indicator.
Pull the first rows of a CDC dataset into a table.

When not to use it

Global health statistics. Use WHO health statistics.
Hospitals and clinicians. Use US hospitals (CMS).

Search on the canvas

Open the node creator and pick Duaer Data → CDC open data.
Fill Find Datasets (such as influenza), or Dataset (such as ynw2-4viq).
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/cdc-data?words=influenza
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-cdc-data
description: >-
  Duaer CDC open data. CDC open datasets on data.cdc.gov: find datasets by words, then read rows from one dataset, such as influenza deaths or vaccination coverage.
  One successful search uses 1 Duaer credit.
---

# Duaer CDC open data

Duaer CDC open data works in two steps: search the data.cdc.gov catalog for datasets, then read rows from one dataset by its id.

## When to use

- Find the CDC dataset for a disease or indicator.
- Pull the first rows of a CDC dataset into a table.

## When not to use

- Global health statistics. Use https://skills.duaer.com/who-gho.md.
- Hospitals and clinicians. Use https://skills.duaer.com/cms-hospitals.md.

## Call

`GET https://api.duaer.com/v1/data/cdc-data?words=influenza`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`, or `dataset`.

- `words` — Words such as influenza deaths or vaccination coverage.
- `dataset` — Optional. Dataset id such as ynw2-4viq to read its rows instead.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/cdc-data?words=influenza` — CDC datasets about influenza.
- `GET https://api.duaer.com/v1/data/cdc-data?dataset=ynw2-4viq&limit=5` — rows of the provisional flu, pneumonia, and COVID-19 deaths dataset.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- Dataset search: `dataset`, `description`, `publisher`, `category`, `columns`, `dataUpdated`, `downloads`.
- Dataset rows: `dataset` plus the dataset columns as fields.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/who-gho.md — Duaer WHO health statistics
- https://skills.duaer.com/cms-hospitals.md — Duaer US hospitals (CMS)

Questions

How many credits does a CDC open data search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

How do I find a Dataset id for Duaer CDC open data?

Call Duaer CDC open data with only Find Datasets, copy the dataset id from a row, then read rows with it.

In this section

Get started

WHO health statistics in Duaer

In Duaer: Country health statistics from the WHO Global Health Observatory: life expectancy, mortality, disease burden, risk factors, and health systems, by year and sex. One successful search uses 1 credit.

Get started

US hospitals (CMS) in Duaer

In Duaer: Medicare-certified US hospitals from CMS Care Compare: type, ownership, emergency services, and overall star rating. One successful search uses 1 credit.