pub_fluview: CDC FluView ILINet outpatient doctor visits

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

CDC FluView ILINet outpatient doctor visits

Description

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

Obtains information on outpatient inluenza-like-illness (ILI) from U.S. Outpatient Influenza-like Illness Surveillance Network (ILINet).

more information on ILINet, see https://gis.cdc.gov/grasp/fluview/fluportaldashboard.html.

Usage

pub_fluview(
  regions,
  epiweeks = "*",
  ...,
  issues = NULL,
  lag = NULL,
  auth = NULL,
  fetch_args = fetch_args_list()
)

Arguments

regions	character. Vector of location IDs to fetch. Can be "nat" for national, "hhs1"–"hhs10" for HHS Regions, "cen1"–"cen9" for census divisions, lowercase two-letter state or territory abbreviations for most states and territories,"jfk" for New York City, or "ny_minus_jfk" for upstate New York. Full list of locations is available here and here.
epiweeks	timeset. Epiweeks to fetch. Supports epirange() and defaults to all ("*") dates. Format as epirange(startweek, endweek), where startweek and endweek are of the form YYYYWW (string or numeric).
...	not used for values, forces later arguments to bind by name
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.
auth	string. Your restricted access key (not the same as API key).
fetch_args	fetch_args_list(). Additional arguments to pass to fetch(). See fetch_args_list() for details.

Details

The full list of location inputs can be accessed at https://github.com/cmu-delphi/delphi-epidata/blob/main/src/acquisition/fluview/fluview_locations.py.

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").

Examples

pub_fluview(regions = "nat", epiweeks = epirange(201201, 202005))

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