get_covid_stats_for_state: Get COVID-19 Statistics for Specific US State(s)

In infectiousR: Access Infectious and Epidemiological Data via 'disease.sh API'

Get COVID-19 Statistics for Specific US State(s)

Description

Retrieves real-time COVID-19 totals for one or more U.S. states from the 'disease.sh' API.

Usage

get_covid_stats_for_state(states, yesterday = FALSE, allowNull = FALSE)

Arguments

states	A character string with the name of a U.S. state or a comma-separated list of state names. Names must be spelled correctly.
yesterday	Logical. If TRUE, returns data from the previous day. Default is FALSE.
allowNull	Logical. If TRUE, missing values are returned as NA instead of 0. Default is FALSE.

Details

This function sends a GET request to the 'disease.sh' API for COVID-19 statistics in one or more U.S. states. If multiple states are passed, they must be comma-separated and correctly spelled. The 'updated' field is returned in milliseconds and is converted to a POSIXct datetime.

Value

A data frame containing the following columns:

• state: State name.

• updated: Last updated timestamp (converted to human-readable datetime in UTC).

• cases: Total confirmed cases.

• todayCases: New confirmed cases today.

• deaths: Total deaths.

• todayDeaths: New deaths today.

• population: State population estimate.

Note

Requires an internet connection.

References

API Docs: https://disease.sh/docs/#/COVID-19

Examples

# Retrieve COVID-19 data for California
ca <- get_covid_stats_for_state("California")

# Retrieve yesterday's data for New York and Texas
ny_tx <- get_covid_stats_for_state("New York,Texas", yesterday = TRUE)

infectiousR documentation built on June 16, 2025, 5:09 p.m.