NiklasTiede / Covid19PyClient

Python Wrapper of a COVID-19 API. Epidemiological Data about SARS-CoV-2 in Germany (RKI Data). 🇩🇪

A Thin Wrapper for the API of the Robert Koch Institute, Germany.

---

Documentation • Plot Examples

Example

import json
from covid19pyclient import CovidData

covid = CovidData()
data = covid.germany_total()

print(json.dumps(data, sort_keys=True, indent=4, ensure_ascii=False))

{
    "cases": 3682911,
    "casesPer100k": 4428.3475391975035,
    "casesPerWeek": 29248,
    "deaths": 88595,
    "delta": {
        "cases": 1785,
        "deaths": 153,
        "recovered": 11714
    },
    "meta": {
        "contact": "Marlon Lueckert ([e-mail])",
        "info": "https://github.com/marlon360/rki-covid-api",
        "lastCheckedForUpdate": "2021-06-01T08:17:40.241Z",
        "lastUpdate": "2021-05-31T23:00:00.000Z",
        "source": "Robert Koch-Institut"
    },
    "r": {
        "date": "2021-05-27T00:00:00.000Z",
        "value": 0.91
    },
    "recovered": 3498382,
    "weekIncidence": 35.16791712491793
}

Featured Data

• Total number of COVID-19 related cases, deaths, incidence, recovered (country, by state, by district, by demographics)
• Timeseries data (country, districts, vaccinations, tests)
• And data derived therefrom

Installation

You can install covid19pyclient with pip.

$ pip install covid19pyclient

Alternatively, you can download and install covid19pyclient from github:

$ pip install git+https://github.com/NiklasTiede/Covid19PyClient

How to use

CovidData's class methods return the requested as dictionary.

from covid19pyclient import CovidData

covid = CovidData()

Here's a list of all the methods which can be used to access different data about COVID-19 in germany:

covid.germany_total()
covid.germany_timeseries()
covid.germany_by_agegroups()

covid.districts_total()
covid.districts_timeseries()

covid.states_total()
covid.states_by_agegroups()

covid.vaccinations_total()
covid.vaccinations_timeseries()

covid.testing_timeseries()

For more information about these function, see Documentation.