Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marlon360/rki-covid-api

🦠🇩🇪📈 An API for the spread of covid-19 in Germany. Data from Robert-Koch-Institut.
https://github.com/marlon360/rki-covid-api

api corona covid-19 covid-data daten deaths deutschland germany hospitalisierung impfquote impfungen infection json json-api karte map r-wert rki robert-koch-institut state

Last synced: 4 days ago
JSON representation

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

Awesome Lists containing this project

README

        

# 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](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](https://github.com/marlon360/rki-covid-api)).
Leave a star if you like it or [open an issue](https://github.com/marlon360/rki-covid-api/issues/new) 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

- [Germany](https://api.corona-zahlen.org/docs/endpoints/germany.html)
- [States](https://api.corona-zahlen.org/docs/endpoints/states.html)
- [Districts](https://api.corona-zahlen.org/docs/endpoints/districts.html)
- [Vaccinations](https://api.corona-zahlen.org/docs/endpoints/vaccinations.html)
- [Maps](https://api.corona-zahlen.org/docs/endpoints/maps.html)
- [Testing](https://api.corona-zahlen.org/docs/endpoints/testing.html)

## 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:

```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
```

2. 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!](https://github.com/marlon360/rki-covid-api/issues/new)

- 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](https://github.com/Nlea/camunda-cloud-corona-update-process)
- 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/)
- Covid-19 Analysis and Visualisation (http://mb.cmbt.de), github: (https://github.com/1c3t3a/Covid-19-analysis)
- Dashboard: 7-Tage Prognosen für Fallzahlen auf kommunaler Ebene (https://covid-prognosen.de)
- Visualisierte Daten, cases Germany, Hospitalizations age-groups, german states, 7-day-incidence (https://dataminer.de) im Menue 'Stuff'

## License

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

## Acknowledgements

Special thanks to [@Rubber1Duck](https://github.com/Rubber1Duck) for all of his contributions and effort to keep this API running!