COVID19-India API
A volunteer-driven, crowdsourced database for COVID-19 stats & patient tracing in India
About Raw Data
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 five 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 (Data till EoD May 09th)
api.covid19india.org/raw_data4.json (Data till EoD May 23rd)
api.covid19india.org/raw_data5.json (Data till EoD Jun 04th)
api.covid19india.org/raw_data6.json (Live 🚀)
Also, there are some structural difference since raw_data3.json : When a new report/bulletin is released from a state regarding confirmed cases :
-
If patient level information is available (from several states like KA,KL,BH etc.), that is captured.
-
If only districtwise information is available, one row is entered for each district, and "numcases" field mentions the number of cases in that district
-
If only statewise information is available, one row is added added for the entire state (DL 👀)
-
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
We are working on providing a singular raw_data that can be the source of truth. However, we strongly advise you to use the aggrgate information for any analysis.
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 (From Apr 20 to Apr 26) | https://api.covid19india.org/raw_data2.json |
| 💚 | Patient Level : Raw Data Partition 3 (From Apr 27 to May 09) | https://api.covid19india.org/raw_data3.json |
| 💚 | Patient Level : Raw Data Partition 4 (From May 10 to May 23) | https://api.covid19india.org/raw_data4.json |
| 💚 | Patient Level : Raw Data Partition 5 (From May 24 to Jun 04) | https://api.covid19india.org/raw_data5.json |
| 💚 | Patient Level : Raw Data Partition 6 (From Jun 5th onwards) | https://api.covid19india.org/raw_data6.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 |
| 💚 | National/State/District Level : Latest cummulative/daily counts | https://api.covid19india.org/v3/data.json |
| 💚 | National/State/District Level : Old per-date cummulative/daily counts | https://api.covid19india.org/v3/data-{YYYY-MM-DD}.json |
| 💚 | National/State/District Level : All dates cummulative/daily counts | https://api.covid19india.org/v3/data-all.json |
| 💚 | National/State Level: Timeseries (different structure) | https://api.covid19india.org/v3/timeseries.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 :)
Alternate API's by Contributors
API for current cases, statewise, districtwise and historical data of India COVID-19
- Graphql playground - https://covidstat.info/graphql API documentation
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
- We use Github Actions to fetch the data from the sheet to the repo periodically.
- Static json and csv files into the gh-pages repository
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 regarding covid19india.org website in the react-site repository
- DO NOT change anything in
gh-pagesbranch directly.They get replaced automatically
Quick Links
Projects Using This API
- COVID-19 INDIA TRACKER (Main Dashboard)
- covid19india.org Ops Telegram Channel (News and Announcements from covid19india.org Team)
- Telegram instant Updates (Instant Updates from covid19india.org Team)
Some other categories of projects using this API:
.................