# Robert Koch-Institut API - by Marlon Lückert

A JSON Rest API to query all relevant corona data for Germany based on the figures of the Robert Koch-Institut.

cases 🤧 - deaths ☠️ - recovered 🟢 - R value 📈 - week incidence 📅 - time series 🗓 - states - districts - vaccinations 💉 - maps 🗺 - PCR-tests - age groups 👶👩‍🦳👴 - hospitalization 🏥

https://api.corona-zahlen.org (opens new window)

# ☕️ Donation

If you use this API, please consider supporting me:

Buy Me a Coffee at ko-fi.com

# 🐙 Open Source

This software is open-source and available on GitHub (https://github.com/marlon360/rki-covid-api (opens new window)). Leave a star if you like it or open an issue (opens new window) if you have any questions or problems.

# 🇩🇪 Übersicht

  • Anzahl der Infektionen, Todesfälle, Genesenen
  • 7-Tage-Inzidenz Wert
  • Neuinfektionen, neue Todesfälle, neue Genesene (Differenz zum Vortag)
  • R-Wert (Reproduktion)
  • Impfquote
  • Werte für jedes Bundesland und jeden Landkreis
  • historische Daten für Deutschland, jedes Bundesland and jeden Landkreis
  • Karten mit Bundesländern und Landkreisen
  • Anzahl der wöchentlich durchgeführen PCR-Tests, Anzahl der positiven Tests sowie der Positiv Quote
  • Fallzahlen und Todesfälle pro Altersgruppe
  • Hospitalisierungsrate

# 🇺🇸 Overview

  • cases, deaths, recovered
  • week incidence
  • new cases, deaths, recovered (difference to yesterday)
  • R value (reproduction)
  • vaccinations
  • data per state and district
  • time series for every state and district
  • maps for states and districts
  • number of performed PCR-test, number of positive tests and positivity rate
  • cases and deaths per age group
  • hospitalization

# Endpoints

# Data sources

Time series data

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore (opens new window)

All these values are calculated from the daily RKI Dump

States data

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore (opens new window)

All these values are calculated from the daily RKI Dump

Districts data

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore (opens new window)

All these values are calculated from the daily RKI Dump

Vaccination data

https://github.com/robert-koch-institut/COVID-19-Impfungen_in_Deutschland/raw/master/Aktuell_Deutschland_Bundeslaender_COVID-19-Impfungen.csv (opens new window) for actual vaccination data https://github.com/robert-koch-institut/COVID-19-Impfungen_in_Deutschland/raw/master/Aktuell_Deutschland_Impfquoten_COVID-19.csv (opens new window) for vaccination quotes https://github.com/robert-koch-institut/COVID-19-Impfungen_in_Deutschland/raw/master/Archiv/ (opens new window) for archive data (both, vaccination data and quotes)

R value

https://raw.githubusercontent.com/robert-koch-institut/SARS-CoV-2-Nowcastingund-R-Schaetzung/main/Nowcast_R_aktuell.csv (opens new window)

Testing data

https://github.com/robert-koch-institut/SARS-CoV-2-PCR-Testungen_in_Deutschland/raw/main/SARS-CoV-2-PCR-Testungen_in_Deutschland.xlsx (opens new window)

Frozen-Incidence data

https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Fallzahlen_Kum_Tab_aktuell.xlsx?__blob=publicationFile (opens new window) https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Fallzahlen_Kum_Tab_Archiv.xlsx?__blob=publicationFile (opens new window)

Age groups

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore (opens new window)

All these values are calculated from the daily RKI Dump

Hospitalization data

https://raw.githubusercontent.com/robert-koch-institut/COVID-19-Hospitalisierungen_in_Deutschland/master/Aktuell_Deutschland_COVID-19-Hospitalisierungen.csv (opens new window)

# Host it yourself

# Requirements

  • Docker runtime
  • Docker compose

# Start Server

  1. Setup docker-compose.yml:
version: "3.8"
networks:
  redis-net:
services:
  redis:
    image: redis
    container_name: cache
    expose:
      - 6379
    networks:
      - redis-net
  rki-api:
    image: marlon360/rki-covid-server:v2
    ports:
      - "8080:3000"
    depends_on:
      - redis
    environment:
      - REDISHOST=redis
    networks:
      - redis-net
  1. Start Server:

docker-compose up

Now you can access the server at http://localhost:8080.

# Project Showcase (projects using this API)

Add your project by opening an issue with your project details! (opens new window)

# License

rki-covid-api by Marlon Lückert is licensed under CC BY 4.0