Skip to contents

Search Datasets by Category

Source: R/metadata.R
cdc_datasets_category.Rd

Finds datasets within a specific category on data.cdc.gov. Use cdc_categories() to see available categories.

Usage

cdc_datasets_category(category, query = NULL, limit = 20, exact = FALSE)

Arguments

category

Character. The category name to search for. Supports partial matching (case-insensitive).

query

Character. Optional additional search terms to filter within the category.

limit

Integer. Maximum number of results (default 20, max 100).

exact

Logical. If TRUE, requires exact category match. If FALSE (default), uses partial matching.

Value

A data.frame with columns:

  • id: Dataset identifier for use with cdc_query()

  • name: Dataset title

  • description: Brief description

  • category: Dataset category

  • tags: Comma-separated list of tags

  • updated_at: Last update timestamp

  • rows: Approximate row count (if available)

  • url: Direct link to dataset page

See also

cdc_categories() to list available categories, cdc_datasets() for general keyword search.

Examples

if (FALSE) { # \dontrun{
# Find all vaccination datasets
cdc_datasets_category("Vaccination")

# Find COVID-19 related datasets
cdc_datasets_category("COVID-19")

# Search within a category
cdc_datasets_category("Vaccination", query = "influenza")

# Exact category match
cdc_datasets_category("NCHS", exact = TRUE)
} # }