Skip to contents

Search Datasets by Tag

Source: R/metadata.R
cdc_datasets_tag.Rd

Finds datasets with a specific tag on data.cdc.gov. Use cdc_tags() to see available tags.

Usage

cdc_datasets_tag(tag, query = NULL, limit = 20, exact = FALSE)

Arguments

tag

Character. The tag name to search for. Supports partial matching (case-insensitive) by default.

query

Character. Optional additional search terms to filter results.

limit

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

exact

Logical. If TRUE, requires exact tag 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_tags() to list available tags, cdc_datasets() for general keyword search.

Examples

if (FALSE) { # \dontrun{
# Find datasets tagged with "covid-19"
cdc_datasets_tag("covid-19")

# Find mortality-related datasets
cdc_datasets_tag("mortality")

# Search within tagged datasets
cdc_datasets_tag("vaccination", query = "children")

# Exact tag match
cdc_datasets_tag("brfss", exact = TRUE)
} # }