akanshgulati / api

Our Database

COVID19-India API

A volunteer-driven, crowdsourced database for COVID-19 stats & patient tracing in India

https://github.com/covid19india/api

Update [27 April]

Due to the growing size of the raw data, and the fact that regions like DL, MH, TG are only providing district level information, we have made a change in our data collection. Now, raw data is available in three parts :

api.covid19india.org/raw_data1.json (Data till EoD Apr 19th)
api.covid19india.org/raw_data2.json (Data till EoD Apr 26th)
api.covid19india.org/raw_data3.json (Live 🚀)

Also, there are some structural difference in raw_data3.json : When a new report/bulletin is released from a state regarding confirmed cases :

1. If patient level information is available (from several states like KA,KL,BH etc.), that is captured.

2. If only districtwise information is available, one row is entered for each district, and "numcases" field mentions the number of cases in that district

3. If only statewise information is available, one row is added added for the entire state (DL 👀)

4. Recoveries and Deceased information is also available through raw_data3.json now. Use the "Current Status" field to extract that information.

All other aggregate APIs retain the same behaviour. CSV files for the same are also available through api.covid19india.org/csv/latest/raw_data{n}.csv

JSON

Status	Data	URL
💚	Patient Level : Raw Data Partition 1 (Till Apr 19)	https://api.covid19india.org/raw_data1.json
💚	Patient Level : Raw Data Partition 2 (Till Apr 26)	https://api.covid19india.org/raw_data2.json
💚	Patient Level : Raw Data Partition 3 (Live)	https://api.covid19india.org/raw_data3.json
💚	National Level :Time series, State-wise stats and Test counts	https://api.covid19india.org/data.json
💚	State Level : has district-wise info	https://api.covid19india.org/state_district_wise.json
💚	State Level : has district-wise info V2 (minor difference in structure)	https://api.covid19india.org/v2/state_district_wise.json
💚	State Level : Daily changes	https://api.covid19india.org/states_daily.json
💚	State Level : Testing data	https://api.covid19india.org/state_test_data.json
💚	District Level : Daily changes	https://api.covid19india.org/districts_daily.json
💚	District Level : Zones	https://api.covid19india.org/zones.json
💚	Essentials and resources	https://api.covid19india.org/resources/resources.json
🔚	Raw Data (Partition 1 + Partition 2. Frozen after Apr 26th)	https://api.covid19india.org/raw_data.json
🔚	Deaths and Recoveries (Frozen after Apr 26th)	https://api.covid19india.org/deaths_recoveries.json
🔚	Travel history (No more updated)	https://api.covid19india.org/travel_history.json

CSV

Sometimes, having files in a spreadsheet format is more useful for analysts and scientists. We have provided the files as downloadable csv files in the following location.

Data	URL
Google sheets in CSV	https://api.covid19india.org/csv/

🚀 Quick example : Apply the formula =IMPORTDATA("https://api.covid19india.org/csv/latest/state_wise.csv") in A1 cell of a Google Sheets to get the state data for analysis :)

Projects Using This API

• COVID-19 INDIA TRACKER (Main Dashboard)

Telegram Channels

• covid19india.org Ops Channel (News and Announcements from covid19india.org Team)
• Telegram instant Updates (Instant Updates from covid19india.org Team)

Analysis

• State-wise key stats (by @Ankan_Plotter)
• Stats and viz in Google Data Studio (by @veeyeskay)

Other Trackers/Dashboards

• Tracker (by @skavinvarnan )
• Statistics and Predictive Analysis (India) (by @GnsP)
• TN Specific - Repo
• Tracker (by @anamritraj )
• India & World Tracker (by @thecoducer)
• COVID-19 Track (by @adarshbalu)
• Maharashtra COVID-19 Dashboard/Tracker (by @pranavs80)

Telegram Bots

• CoVID19 India Patients Analyzer and Alerts
• CovidBot: CoVID19 Live Stats Chatbot (by @gurrrung)
• covid19indiatracker_bot
• INDIA COVID-19 Google Map TRACKER

Quick Links

• Telegram Group
• Patient Database

How this works

• Data in this repository is generated from Google Sheets (https://api.covid19india.org/csv)
• Volunteers collect data from trusted sources and update the sheet
• This repo periodically fetches relevant data from the Sheet and create/update static json/csv.
• We use Github Actions to fetch the data periodically and auto-commit. Thank you @Github :)

Contributing

• Contributions to new data formats are welcome. Please create a GH issue and discuss there before working on the same.
• Please raise an issue before submitting a PR
• Report issues with regarding covid19india.org website in the react-site repository
• DO NOT change anything in gh-pages branch directly.They get replaced automatically

Notes

• Do not use the "Current Status" in raw_data.json as we are rarely able to map the status to the exact patient anymore. This will soon be deprecated in a future version of the API.

..........