Skip to contents

Query the new Epidata API (v5)

The current API. See vignette("migration-guide") for how to update covidcast queries.

epidata_meta()
Get cast-API source metadata
epidata_snapshot() epidata_archive() epidata()
cast-API snapshot and archive queries
epidata_aux()
Fetch V5 auxiliary data

Query the covidcast endpoint (v4)

The previous main endpoint, frozen since September 22, 2026. It still serves historical data but receives no new data; use the v5 functions above for current data.

pub_covidcast() deprecated
Various COVID and flu signals via the COVIDcast endpoint
pub_covidcast_meta() deprecated
Metadata for the COVIDcast endpoint
covidcast_epidata()
Creates the COVIDcast Epidata autocomplete helper

Query legacy endpoints (v3)

Older endpoints, each with its own dataset. Most are static or no longer updated.

pub_covid_hosp_facility() deprecated
COVID hospitalizations by facility
pub_covid_hosp_facility_lookup() deprecated
Helper for finding COVID hospitalization facilities
pub_covid_hosp_state_timeseries() deprecated
COVID hospitalizations by state
pub_delphi() deprecated
Delphi's ILINet outpatient doctor visits forecasts
pub_dengue_nowcast() deprecated
Delphi's PAHO dengue nowcasts (North and South America)
pub_ecdc_ili() deprecated
ECDC ILI incidence (Europe)
pub_flusurv() deprecated
CDC FluSurv flu hospitalizations
pub_fluview() deprecated
CDC FluView ILINet outpatient doctor visits
pub_fluview_clinical() deprecated
CDC FluView flu tests from clinical labs
pub_fluview_meta() deprecated
Metadata for the FluView endpoint
pub_gft() deprecated
Google Flu Trends flu search volume
pub_kcdc_ili() deprecated
KCDC ILI incidence (Korea)
pub_meta() deprecated
Metadata for the Delphi Epidata API
pub_nidss_dengue() deprecated
NIDSS dengue cases (Taiwan)
pub_nidss_flu() deprecated
NIDSS flu doctor visits (Taiwan)
pub_nowcast() deprecated
Delphi's ILI Nearby nowcasts
pub_paho_dengue() deprecated
PAHO dengue data (North and South America)
pub_wiki() deprecated
Wikipedia webpage counts by article

Make API requests

Discover endpoints and control how queries are built and fetched

avail_endpoints()
List all available Epidata API endpoints
create_epidata_call() fetch()
An abstraction that holds information needed to make an epidata request
fetch_args_list()
Set custom API request parameters

Configuration and utilities

Set the API key (get_api_key(), save_api_key()), which lifts the anonymous rate limits but does not grant access to private endpoints. Also the date types that endpoints accept: epirange() and timeset.

get_api_key() save_api_key()
Get and set API keys
epirange()
Specify a range of days or weeks for API requests
timeset
Timeset formats for specifying dates

Control caching behavior

Optionally store API responses on disk so repeated calls do not hit the API again. The cache is off by default, and it only stores calls for a fixed past version of the data (not “latest”), since those cannot change. See set_cache() for the environment variables that turn it on.

set_cache()
Create or renew a cache for this session
clear_cache()
Manually reset the cache, deleting all currently saved data and starting afresh
disable_cache()
Turn off the caching for this session
cache_info()
Describe current cache

Make requests to private API endpoints

These endpoints serve restricted data sources. Besides an API key, they need a separate auth token, passed as the auth argument. Access is granted per data source by Delphi, and the token is not the same as the API key. See each endpoint’s page for details.

pvt_cdc() deprecated
CDC total and by topic webpage visits
pvt_dengue_sensors() deprecated
PAHO dengue digital surveillance sensors (North and South America)
pvt_ght() deprecated
Google Health Trends health topics search volume
pvt_meta_norostat() deprecated
Metadata for the NoroSTAT endpoint
pvt_norostat() deprecated
CDC NoroSTAT norovirus outbreaks
pvt_quidel() deprecated
Quidel COVID-19 and influenza testing data
pvt_sensors() deprecated
Influenza and dengue digital surveillance sensors
pvt_twitter() deprecated
HealthTweets total and influenza-related tweets