Skip to main content

Python API Wrapper for tracking Coronavirus (COVID-19, SARS-CoV-2) via

Project description


Downloads Downloads Downloads GPLv3 License All Contributors CodeFactor HitCount GitHub stars

Python API Wrapper for tracking Coronavirus (COVID-19, SARS-CoV-2) via


COVID19Py is a Python wrapper for the ExpDev07/coronavirus-tracker-api REST API. It retrieves data directly from @ExpDev07's backend but it can also be set up to use a different backend.

To achieve this, just pass the URL of the backend as a parameter to the library's constructor:

import COVID19Py
covid19 = COVID19Py.COVID19("https://my-awesome-covid19-backend")


In order install this package, simply run:

pip install COVID19Py


To use COVID19Py, you first need to import the package and then create a new instance:

import COVID19Py
covid19 = COVID19Py.COVID19()

Getting latest amount of total confirmed cases, deaths, and recoveries:

latest = covid19.getLatest()

Getting all locations:

locations = covid19.getLocations()


locations = covid19.getLocations(timelines=True)

to also get timelines.

You can also rank the results by confirmed, deaths or recovered.

locations = covid19.getLocations(rank_by='recovered')

Getting location by country code:

location = covid19.getLocationByCountryCode("US")


location = covid19.getLocationByCountryCode("US", timelines=True)

to also get timelines.

Getting a specific location (includes timelines by default):

location = covid19.getLocationById(39)

Getting all data at once:

You can also get all the available data with one command.

data = covid19.getAll()


data = covid19.getAll(timelines=True)

to also get timelines.

latest will be available on data["latest"] and locations will be available on data["locations"].

Getting latest deltas:

When using getAll(), COVID19Py will also store the previous version of the retrieved data. This allows us to easily see how data changed since the last time we requested them.

changes = covid19.getLatestChanges()
    "confirmed": 512,
    "deaths": 16,
    "recovered": 1024

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Konstantinos Kamaropoulos

💻 📖 💡

Jarod DeWeese

💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

COVID19Py-0.2.0.tar.gz (4.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page