TheMushrr00m / coronavirus-tracker-api

🦠 A simple and fast (< 200ms) API for tracking the global coronavirus (COVID-19, SARS-CoV-2) outbreak. It's written in python using the 🍼 Flask framework.

coronavirus-tracker (API)

This is a fast (< 200ms) and basic API for tracking development of the new coronavirus (COVID-19, SARS-CoV-2). It's written in python using 🍼 Flask.

Endpoints

All requests must be made to the base url: https://coronavirus-tracker-api.herokuapp.com (e.g: https://coronavirus-tracker-api.herokuapp.com/all). You can try them out in your browser to further inspect responses.

Getting confirmed cases, deaths, and recoveries:

GET /all

{ "latest": { ... }, "confirmed": { ... }, "deaths": { ... }, "recovered": { ... } }

Getting just confirmed:

GET /confirmed

{
  "latest": 42767,
  "locations": [ ... ], 
  "last_updated": "2020-03-07T18:08:58.432242Z", 
  "source": "https://github.com/ExpDev07/coronavirus-tracker-api" 
}

Getting just deaths:

GET /deaths

Getting just recoveries:

GET /recovered

Data

The data comes from the 2019 Novel Coronavirus (nCoV) Data Repository, provided by JHU CCSE. It is programmatically retrieved, re-formatted and stored in the cache for one hour.

Wrappers

These are the available API wrappers created by the community. They are not neccecarily maintained by any of this project's authors or contributors.

Java

• Coronavirus by @mew.

Prerequisites

You will need the following things properly installed on your computer.

• Python 3 (with pip)
• Flask
• pipenv

Installation

• git clone https://github.com/ExpDev07/coronavirus-tracker-api.git
• cd coronavirus-tracker-api
• pipenv shell
• pipenv install

Running / Development

• flask run
• Visit your app at http://localhost:5000.

Running Tests

Linting

Building

Deploying

Contributors ✨

Thanks goes to these wonderful people (emoji key):

ExpDev 💻 📖 🚧

bjarkimg 💬

Bost 📖

License

The data is available to the public strictly for educational and academic research purposes. Please link to this repo somewhere in your project if you can (not required) :).