Skip to contents

Query the new Epidata API (v5)

The current API. Sources are moving here from the covidcast endpoint; 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. Still carries the sources that have not moved to v5 yet.

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 API keys and handle API data types

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

Configure an optional persistent cache

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 require additional authorization to use

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