pub_covidcast: Various COVID and flu signals via the COVIDcast endpoint

In epidatr: Client for Delphi's 'Epidata' API

Various COVID and flu signals via the COVIDcast endpoint

Description

API docs: https://cmu-delphi.github.io/delphi-epidata/api/covidcast_signals.html

The primary endpoint for fetching COVID-19 data, providing access to a wide variety of signals from a wide variety of sources. See the API documentation link above for more. Delphi's COVIDcast public dashboard is powered by this endpoint.

Usage

pub_covidcast(
  source,
  signals,
  geo_type,
  time_type,
  geo_values = "*",
  time_values = "*",
  ...,
  as_of = NULL,
  issues = NULL,
  lag = NULL,
  fetch_args = fetch_args_list()
)

Arguments

source	string. The data source to query (see: https://cmu-delphi.github.io/delphi-epidata/api/covidcast_signals.html).
signals	string. The signals to query from a specific source (see: https://cmu-delphi.github.io/delphi-epidata/api/covidcast_signals.html).
geo_type	string. The geographic resolution of the data (see: https://cmu-delphi.github.io/delphi-epidata/api/covidcast_geography.html).
time_type	string. The temporal resolution of the data (either "day" or "week", depending on signal).
geo_values	character. The geographies to return. Defaults to all ("*") geographies within requested geographic resolution (see: https://cmu-delphi.github.io/delphi-epidata/api/covidcast_geography.html.).
time_values	timeset. Dates or epiweeks to fetch. Supports epirange() and defaults to all ("*") dates.
...	not used for values, forces later arguments to bind by name
as_of	Date. Optionally, the as-of date for the issues to fetch. See the "Data Versioning" section for details.
issues	timeset. Optionally, the issue(s) of the data to fetch. See the "Data Versioning" section for details.
lag	integer. Optionally, the lag of the issues to fetch. See the "Data Versioning" section for details.
fetch_args	fetch_args_list(). Additional arguments to pass to fetch(). See fetch_args_list() for details.

Value

tibble::tibble

Data Versioning

Several endpoints support retrieving historical versions of the data. The following parameters control this and are mutually exclusive (only one can be provided at a time).

• as_of: (Date) Retrieve the data as it was on this date.

• issues: timeset Retrieve data from a specific issue date or range of dates.

• lag: (integer) Retrieve data with a specific lag from its issue date.

If none of these is specified, the most recent version of the data is returned.

See vignette("versioned-data") for details and more ways to specify versioned data.

See also

For example queries showing how to discover signals and build calls, see vignette("signal-discovery", package = "epidatr").

See Also

pub_covidcast_meta(), covidcast_epidata(), epirange()

Examples

pub_covidcast(
  source = "jhu-csse",
  signals = "confirmed_7dav_incidence_prop",
  geo_type = "state",
  time_type = "day",
  geo_values = c("ca", "fl"),
  time_values = epirange(20200601, 20200801)
)
pub_covidcast(
  source = "jhu-csse",
  signals = "confirmed_7dav_incidence_prop",
  geo_type = "state",
  time_type = "day",
  geo_values = "*",
  time_values = epirange(20200601, 20200801)
)

epidatr documentation built on June 3, 2026, 1:06 a.m.