Skip to content

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

License

Notifications You must be signed in to change notification settings

marlon360/rki-covid-api

Repository files navigation

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://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore

All these values are calculated from the daily RKI Dump

States data

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore

All these values are calculated from the daily RKI Dump

Districts data

https://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore

All these values are calculated from the daily RKI Dump

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://github.com/robert-koch-institut/SARS-CoV-2-PCR-Testungen_in_Deutschland/raw/main/SARS-CoV-2-PCR-Testungen_in_Deutschland.xlsx

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://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore

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

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!

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!