rki-covid-api icon indicating copy to clipboard operation
rki-covid-api copied to clipboard

🦠🇩🇪📈 An API for the spread of covid-19 in Germany. Data from Robert-Koch-Institut.

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

☕️ 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). Leave a star if you like it or open an issue 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://npgeo-corona-npgeo-de.hub.arcgis.com/datasets/dd4580c810204019a7b8eb3e0b329dd6_0

States data

https://npgeo-corona-npgeo-de.hub.arcgis.com/datasets/ef4b445a53c1406892257fe63129a8ea_0

Districts data

https://npgeo-corona-npgeo-de.hub.arcgis.com/datasets/917fc37a709542548cc3be077a786c17_0

Vaccination data

https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Impfquotenmonitoring.xlsx?__blob=publicationFile

R value

https://raw.githubusercontent.com/robert-koch-institut/SARS-CoV-2-Nowcasting_und_-R-Schaetzung/main/Nowcast_R_aktuell.csv

Testing data

https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Testzahlen-gesamt.xlsx?__blob=publicationFile

Frozen-Incidence data

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

Age groups

https://npgeo-corona-npgeo-de.hub.arcgis.com/datasets/23b1ccb051f543a5b526021275c1c6e5_0

Hospitalization data

https://raw.githubusercontent.com/robert-koch-institut/COVID-19-Hospitalisierungen_in_Deutschland/master/Aktuell_Deutschland_COVID-19-Hospitalisierungen.csv

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!

  • CoronaBot Deutschland (https://twitter.com/CoronaBot_DEU)
  • Fallzahlen Aktuell - Inzidenz & mehr aus DE (https://play.google.com/store/apps/details?id=com.kokoschka.michael.casestoday&hl=de)
  • ImpfPush - Benachrichtigung über aktuelle Inzidenz-Zahlen aus Ihrer Region (https://www.impfpush.de)
  • Home Assistant Integration (https://github.com/thebino/rki_covid)
  • Corona Charts für Deutschland (https://corona.maximilianhaindl.de)
  • Corona Infos für das Berchtesgadener Land mit Zusatzinfos (https://covid.webreload.de/)
  • Twitter bot for vaccination numbers (https://twitter.com/impfstatus)
  • App Infektionsgeschehen (https://play.google.com/store/apps/details?id=de.geekbits.infektionsgeschehen)
  • App: corona-wiki (https://v-braun.github.io/corona-wiki)
  • small project to show some data (https://www.corona-zahlen.net/)
  • Corona Update Germany Telegram Channel (https://t.me/corona_update_germany), Project can be found here
  • Die Corona Zahlen im Frankenjura (https://www.frankenjura.com/frankenjura/corona)
  • COVID-19 Impfdauer-Rechner (https://www.impfdauer.de)
  • Discord Corona Bot (https://github.com/markxoe/covid-bot)
  • COVID-19 Dashboard (https://covid.beyerleinf.de)
  • 7-Tage-Inzidenz Verlauf mit Vergleich beliebiger Städte/Länder (https://incidence-trend.web.app/)
  • COVID-19 Scriptable Dashboard (https://gist.github.com/marcusraitner/a1b633625d1016498eaaab712461dfc4)
  • Corona statistics with diagrams (https://corona.jnebel.de/)
  • Twitter account with this API (https://twitter.com/GermanyCovid)
  • Corona, what's going on in your county or city (https://chrnoe.de/corona)
  • Wordpress Widget zur Anzeige der letzen 3 Inzidenzen für einen Landkreis (https://github.com/p-tenz/widget-7d-incidence)
  • Informatives Dashboard, zum schnellen Überblick des Status der Corona-Schutzimpfungen in Deutschland (https://www.impfung.io/)
  • Discordbot at (https://germanycovid.de/discord)
  • Web App for vaccination numbers which issues a Push Notification whenever the new vaccination numbers are available (https://vacstats.laurenzfg.com)
  • Fallzahlen Statistik App (https://play.google.com/store/apps/details?id=com.companyname.statforms)
  • Germany Covidometer (https://arashesdr.github.io/covidometer/)
  • Pandemie jetzt (https://pandemie.jetzt/)
  • Corona Zahlen in Deutschland (Wordpress Plugin) (https://de.wordpress.org/plugins/corona-zahlen-deutschland-cng/)
  • 7-Tage-Inzidenzen der letzten Tage (https://corona-germany.justus-d.de/)
  • Die Krankenhausampel für einen (beliebigen) Landkreis als freies und anpassbares Skript für alle Webseitenbetreiber (https://krankenhausampel.info/)
  • Corona_Ampel_Bayern, Übersicht über aktuelle Zahlen für Bayern und deren Landkreise. (https://corona-ampel-bayern.de)
  • Casumer Corona Tracker - Eine Svelte PWA zur Überwachung frei konfigurierbarer Landkreise (https://cct.greeninc.ga)
  • Covid Landkreis Zahlen Chatbot auf Telegram (https://t.me/COVID_19_GER_bot)
  • DiscordCoronaBot, Zahlen, Tägliche Updates und Vorhersagen zu Covid-19 (https://github.com/GlaubeKeinemDev/DiscordCoronaBot)
  • Statistik für Baden-Württemberg mit Differenz zum Vortag (https://corona-in-bw.de)
  • Covid 19 Statistics Germany (https://covid19ger.netlify.app/)

License

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

Acknowledgements

Special thanks to @Rubber1Duck for all of his contributions and effort to keep this API running!