/api

Our Database

Primary LanguagePythonMIT LicenseMIT

COVID19-India API

A volunteer-driven, crowd-sourced database for COVID-19 stats & patient tracing in India.

Source Code on Github

API Documentation

Detailed documentation regarding the API end-points can be found here

JSON Endpoints

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 05 to Jun 19) https://api.covid19india.org/raw_data6.json
💚 Patient Level : Raw Data Partition 7 (From Jun 20 to Jun 30) https://api.covid19india.org/raw_data7.json
💚 Patient Level : Raw Data Partition 8 (From Jul 01 to Jul 07) https://api.covid19india.org/raw_data8.json
💚 Patient Level : Raw Data Partition 9 (From Jul 08 to Jul 13) https://api.covid19india.org/raw_data9.json
💚 Patient Level : Raw Data Partition 10 (From Jul 14 to Jul 17) https://api.covid19india.org/raw_data10.json
💚 Patient Level : Raw Data Partition 11 (From Jul 18 to Jul 22) https://api.covid19india.org/raw_data11.json
💚 Patient Level : Raw Data Partition 12 (From Jul 23 to Aug 06) https://api.covid19india.org/raw_data12.json
💚 Patient Level : Raw Data Partition 13 (From Aug 07 to Aug 21) https://api.covid19india.org/raw_data13.json
💚 Patient Level : Raw Data Partition 14 (From Aug 22 to Sep 05) https://api.covid19india.org/raw_data14.json
💚 Patient Level : Raw Data Partition 15 (From Sep 06 to Sep 21) https://api.covid19india.org/raw_data15.json
💚 Patient Level : Raw Data Partition 16 (From Sep 22 to Oct 08) https://api.covid19india.org/raw_data16.json
💚 Patient Level : Raw Data Partition 17 (From Oct 09 onwards) https://api.covid19india.org/raw_data17.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 : 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 cumulative/daily counts https://api.covid19india.org/v4/data.json
💚 National/State/District Level : Specific date cummulative/daily counts https://api.covid19india.org/v4/data-YYYY-MM-DD.json
💚 National/State/District Level : Historical date-wise cumulative/daily counts https://api.covid19india.org/v4/data-all.json
💚 National/State Level: Timeseries_(different structure)_ https://api.covid19india.org/v4/timeseries.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 at the following location.

Data URL
Google sheets in CSV https://api.covid19india.org/documentation/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 :)

How this works

  • Data in this repository is generated from Google Sheets
  • Volunteers collect data from trusted sources and update the sheet
  • Github Actions periodically fetch the data from the sheet and upload static json and csv files into gh-pages branch of this repo
  • gh-pages serves the json/csv files at https://api.covid19india.org

License

This repository contains both the code that routinely fetches the data from Google Sheet and convert it into JSON files in the required format and the data itself (in the gh-pages branch). So, the content of this repository is licensed in two ways : Code and Data

License for Code (Consider this as everything in the master branch) : MIT License (Detailed in LICENSE_CODE.txt)
License for Data (Consider this as everything in the gh-pages branch) : CC-BY-4.0 License (Detailed in LICENSE_DATA.txt)

Citation

You can cite us in your work in the following format

@misc{covid19indiaorg2020tracker,
  author = {COVID-19 India Org Data Operations Group},
  title = {{Dataset for tracking COVID-19 spread in India}},
  howpublished = {Accessed on yyyy-mm-dd from \url{https://api.covid19india.org/}},
  year = 2020
}

Contributing

  • Contributions to new data formats and making the data fetch process more efficient are welcome.
  • Please create a GH issue and discuss your idea before working on the same.
  • Report issues regarding https://www.covid19india.org website in the react-site repository
  • DO NOT change anything in gh-pages branch directly as they get replaced automatically every 10 minutes.

Quick Links


Team Projects Using This API

............................................