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
which do not apply if you use an API key to authenticate your queries. For
more information, see
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.
- Getting Started
- Fetching Data
- Plotting Examples
- Plotting Reference
- v0.2.2, October 10, 2023
- v0.2.1, June 1, 2023
- v0.2.0, May 23, 2023
- v0.1.5, May 11, 2021
- v0.1.4, February 24, 2021
- v0.1.3, January 5, 2021
- v0.1.2, December 10, 2020
- v0.1.1, November 22, 2020
- v0.1.0, October 1, 2020
- v0.0.9, August 30, 2020
- v0.0.8, July 26, 2020
- v0.0.7, June 29, 2020
- v0.0.6, June 22, 2020
- v0.0.5, June 19, 2020