COVIDcast API client

This package provides Python access to the COVIDcast Epidata API published by the Delphi group at Carnegie Mellon University. This API provides daily access to a range of COVID-related signals Delphi collects from a variety of sources, including cases, deaths, symptom surveys, healthcare data, and other information.

Consult the COVIDcast Epidata API documentation for details on the data included in the API, licensing, and how to cite this data in your work. The signals documentation lists all the data sources and signals available through this API.

The package source code and bug tracker can be found on GitHub.

To get started, check out getting started.


You should consider subscribing to the API mailing list to be notified of package updates, new data sources, corrections, and other updates.


By default, this package submits queries to the API anonymously. All the examples in the package documentation are compatible with anonymous use of the API, but there are some limits on anonymous queries which do not apply if you use an API key to authenticate your queries. For more information, see covidcast.use_api_key().

As we are a research group, our server resources are limited and cannot support high-volume interactive use (with or without an API key). If you use data from the COVIDcast Epidata API to power a public product, dashboard, app, or other service, please download the data you need and store it centrally rather than making API requests for every user.

See also the COVIDcast Terms of Use, noting that the data is a research product and not warranted for a particular purpose.