{"id":21338911,"url":"https://github.com/marlon360/rki-covid-api","last_synced_at":"2025-05-16T11:05:19.956Z","repository":{"id":37095362,"uuid":"248936189","full_name":"marlon360/rki-covid-api","owner":"marlon360","description":"🦠🇩🇪📈 An API for the spread of covid-19 in Germany. Data from Robert-Koch-Institut.","archived":false,"fork":false,"pushed_at":"2025-03-11T02:29:49.000Z","size":16782,"stargazers_count":249,"open_issues_count":15,"forks_count":48,"subscribers_count":14,"default_branch":"v2","last_synced_at":"2025-04-09T07:01:57.561Z","etag":null,"topics":["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"],"latest_commit_sha":null,"homepage":"https://api.corona-zahlen.org/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marlon360.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"marlon360","ko_fi":"marlon360"}},"created_at":"2020-03-21T08:33:08.000Z","updated_at":"2025-01-24T22:23:10.000Z","dependencies_parsed_at":"2023-10-03T12:17:23.733Z","dependency_job_id":"7147e67c-1ef0-4dde-99a3-9130c20f5a4d","html_url":"https://github.com/marlon360/rki-covid-api","commit_stats":{"total_commits":462,"total_committers":23,"mean_commits":20.08695652173913,"dds":0.5043290043290043,"last_synced_commit":"b9726dff53390c2dbe51a7caf8896b41cd267d29"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlon360%2Frki-covid-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlon360%2Frki-covid-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlon360%2Frki-covid-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlon360%2Frki-covid-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marlon360","download_url":"https://codeload.github.com/marlon360/rki-covid-api/tar.gz/refs/heads/v2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518384,"owners_count":22084374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-11-22T00:41:12.853Z","updated_at":"2025-05-16T11:05:14.947Z","avatar_url":"https://github.com/marlon360.png","language":"TypeScript","funding_links":["https://github.com/sponsors/marlon360","https://ko-fi.com/marlon360","https://ko-fi.com/marlon360'"],"categories":[],"sub_categories":[],"readme":"# Robert Koch-Institut API - by Marlon Lückert\n\nA JSON Rest API to query all relevant corona data for Germany based on the figures of the Robert Koch-Institut.\n\ncases 🤧 - deaths ☠️ - recovered 🟢 - **R value** 📈 - week incidence 📅 - **time series** 🗓 - states - districts - **vaccinations** 💉 - **maps** 🗺 - PCR-tests - age groups 👶👩‍🦳👴 - hospitalization 🏥\n\n[https://api.corona-zahlen.org](https://api.corona-zahlen.org)\n\n## ☕️ Donation\n\nIf you use this API, please consider supporting me:\n\n\u003ca href='https://ko-fi.com/marlon360' target='_blank'\u003e\u003cimg height='35' style='border:0px;height:48px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n## 🐙 Open Source\n\nThis software is open-source and available on GitHub ([https://github.com/marlon360/rki-covid-api](https://github.com/marlon360/rki-covid-api)).\nLeave 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.\n\n## 🇩🇪 Übersicht\n\n- Anzahl der Infektionen, Todesfälle, Genesenen\n- 7-Tage-Inzidenz Wert\n- Neuinfektionen, neue Todesfälle, neue Genesene (Differenz zum Vortag)\n- R-Wert (Reproduktion)\n- Impfquote\n- Werte für jedes Bundesland und jeden Landkreis\n- historische Daten für Deutschland, jedes Bundesland and jeden Landkreis\n- Karten mit Bundesländern und Landkreisen\n- Anzahl der wöchentlich durchgeführen PCR-Tests, Anzahl der positiven Tests sowie der Positiv Quote\n- Fallzahlen und Todesfälle pro Altersgruppe\n- Hospitalisierungsrate\n\n## 🇺🇸 Overview\n\n- cases, deaths, recovered\n- week incidence\n- new cases, deaths, recovered (difference to yesterday)\n- R value (reproduction)\n- vaccinations\n- data per state and district\n- time series for every state and district\n- maps for states and districts\n- number of performed PCR-test, number of positive tests and positivity rate\n- cases and deaths per age group\n- hospitalization\n\n## Endpoints\n\n- [Germany](https://api.corona-zahlen.org/docs/endpoints/germany.html)\n- [States](https://api.corona-zahlen.org/docs/endpoints/states.html)\n- [Districts](https://api.corona-zahlen.org/docs/endpoints/districts.html)\n- [Vaccinations](https://api.corona-zahlen.org/docs/endpoints/vaccinations.html)\n- [Maps](https://api.corona-zahlen.org/docs/endpoints/maps.html)\n- [Testing](https://api.corona-zahlen.org/docs/endpoints/testing.html)\n\n## Data sources\n\n**Time series data**\n\nhttps://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore\n\nAll these values are calculated from the daily RKI Dump\n\n**States data**\n\nhttps://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore\n\nAll these values are calculated from the daily RKI Dump\n\n**Districts data**\n\nhttps://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore\n\nAll these values are calculated from the daily RKI Dump\n\n**Vaccination data**\n\nhttps://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Impfquotenmonitoring.xlsx?__blob=publicationFile\n\n**R value**\n\nhttps://raw.githubusercontent.com/robert-koch-institut/SARS-CoV-2-Nowcasting_und_-R-Schaetzung/main/Nowcast_R_aktuell.csv\n\n**Testing data**\n\nhttps://github.com/robert-koch-institut/SARS-CoV-2-PCR-Testungen_in_Deutschland/raw/main/SARS-CoV-2-PCR-Testungen_in_Deutschland.xlsx\n\n**Frozen-Incidence data**\n\nhttps://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Fallzahlen_Kum_Tab_aktuell.xlsx?__blob=publicationFile\nhttps://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Daten/Fallzahlen_Kum_Tab_Archiv.xlsx?__blob=publicationFile\n\n**Age groups**\n\nhttps://github.com/Rubber1Duck/RD_RKI_COVID19_DATA/tree/master/dataStore\n\nAll these values are calculated from the daily RKI Dump\n\n**Hospitalization data**\n\nhttps://raw.githubusercontent.com/robert-koch-institut/COVID-19-Hospitalisierungen_in_Deutschland/master/Aktuell_Deutschland_COVID-19-Hospitalisierungen.csv\n\n## Host it yourself\n\n### Requirements\n\n- Docker runtime\n- Docker compose\n\n### Start Server\n\n1. Setup docker-compose.yml:\n\n```yml\nversion: \"3.8\"\nnetworks:\n  redis-net:\nservices:\n  redis:\n    image: redis\n    container_name: cache\n    expose:\n      - 6379\n    networks:\n      - redis-net\n  rki-api:\n    image: marlon360/rki-covid-server:v2\n    ports:\n      - \"8080:3000\"\n    depends_on:\n      - redis\n    environment:\n      - REDISHOST=redis\n    networks:\n      - redis-net\n```\n\n2. Start Server:\n\n`docker-compose up`\n\nNow you can access the server at `http://localhost:8080`.\n\n## Project Showcase (projects using this API)\n\n[Add your project by opening an issue with your project details!](https://github.com/marlon360/rki-covid-api/issues/new)\n\n- CoronaBot Deutschland (https://twitter.com/CoronaBot_DEU)\n- Fallzahlen Aktuell - Inzidenz \u0026 mehr aus DE\n  (https://play.google.com/store/apps/details?id=com.kokoschka.michael.casestoday\u0026hl=de)\n- ImpfPush - Benachrichtigung über aktuelle Inzidenz-Zahlen aus Ihrer Region (https://www.impfpush.de)\n- Home Assistant Integration (https://github.com/thebino/rki_covid)\n- Corona Charts für Deutschland (https://corona.maximilianhaindl.de)\n- Corona Infos für das Berchtesgadener Land mit Zusatzinfos (https://covid.webreload.de/)\n- Twitter bot for vaccination numbers (https://twitter.com/impfstatus)\n- App Infektionsgeschehen (https://play.google.com/store/apps/details?id=de.geekbits.infektionsgeschehen)\n- App: corona-wiki (https://v-braun.github.io/corona-wiki)\n- small project to show some data (https://www.corona-zahlen.net/)\n- 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)\n- Die Corona Zahlen im Frankenjura (https://www.frankenjura.com/frankenjura/corona)\n- COVID-19 Impfdauer-Rechner (https://www.impfdauer.de)\n- Discord Corona Bot (https://github.com/markxoe/covid-bot)\n- COVID-19 Dashboard (https://covid.beyerleinf.de)\n- 7-Tage-Inzidenz Verlauf mit Vergleich beliebiger Städte/Länder (https://incidence-trend.web.app/)\n- COVID-19 Scriptable Dashboard (https://gist.github.com/marcusraitner/a1b633625d1016498eaaab712461dfc4)\n- Corona statistics with diagrams (https://corona.jnebel.de/)\n- Twitter account with this API (https://twitter.com/GermanyCovid)\n- Corona, what's going on in your county or city (https://chrnoe.de/corona)\n- Wordpress Widget zur Anzeige der letzen 3 Inzidenzen für einen Landkreis (https://github.com/p-tenz/widget-7d-incidence)\n- Informatives Dashboard, zum schnellen Überblick des Status der Corona-Schutzimpfungen in Deutschland (https://www.impfung.io/)\n- Discordbot at (https://germanycovid.de/discord)\n- Web App for vaccination numbers which issues a Push Notification whenever the new vaccination numbers are available (https://vacstats.laurenzfg.com)\n- Fallzahlen Statistik App (https://play.google.com/store/apps/details?id=com.companyname.statforms)\n- Germany Covidometer (https://arashesdr.github.io/covidometer/)\n- Pandemie jetzt (https://pandemie.jetzt/)\n- Corona Zahlen in Deutschland (Wordpress Plugin) (https://de.wordpress.org/plugins/corona-zahlen-deutschland-cng/)\n- 7-Tage-Inzidenzen der letzten Tage (https://corona-germany.justus-d.de/)\n- Die Krankenhausampel für einen (beliebigen) Landkreis als freies und anpassbares Skript für alle Webseitenbetreiber (https://krankenhausampel.info/)\n- Corona_Ampel_Bayern, Übersicht über aktuelle Zahlen für Bayern und deren Landkreise. (https://corona-ampel-bayern.de)\n- Casumer Corona Tracker - Eine Svelte PWA zur Überwachung frei konfigurierbarer Landkreise (https://cct.greeninc.ga)\n- Covid Landkreis Zahlen Chatbot auf Telegram (https://t.me/COVID_19_GER_bot)\n- DiscordCoronaBot, Zahlen, Tägliche Updates und Vorhersagen zu Covid-19 (https://github.com/GlaubeKeinemDev/DiscordCoronaBot)\n- Statistik für Baden-Württemberg mit Differenz zum Vortag (https://corona-in-bw.de)\n- Covid 19 Statistics Germany (https://covid19ger.netlify.app/)\n- Covid-19 Analysis and Visualisation (http://mb.cmbt.de), github: (https://github.com/1c3t3a/Covid-19-analysis)\n- Dashboard: 7-Tage Prognosen für Fallzahlen auf kommunaler Ebene (https://covid-prognosen.de)\n- Visualisierte Daten, cases Germany, Hospitalizations age-groups, german states, 7-day-incidence (https://dataminer.de) im Menue 'Stuff'\n\n## License\n\n\u003cp xmlns:dct=\"http://purl.org/dc/terms/\" xmlns:cc=\"http://creativecommons.org/ns#\" class=\"license-text\"\u003e\u003ca rel=\"cc:attributionURL\" property=\"dct:title\" href=\"https://rki.marlon-lueckert.de\"\u003erki-covid-api\u003c/a\u003e by \u003ca rel=\"cc:attributionURL dct:creator\" property=\"cc:attributionName\" href=\"https://marlon-lueckert.de\"\u003eMarlon Lückert\u003c/a\u003e is licensed under \u003ca rel=\"license\" href=\"https://creativecommons.org/licenses/by/4.0\"\u003eCC BY 4.0\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1\" /\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1\" /\u003e\u003c/a\u003e\u003c/p\u003e\n\n## Acknowledgements\n\nSpecial thanks to [@Rubber1Duck](https://github.com/Rubber1Duck) for all of his contributions and effort to keep this API running!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarlon360%2Frki-covid-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarlon360%2Frki-covid-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarlon360%2Frki-covid-api/lists"}