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.
All requests must be made to the base url: https://coronavirus-tracker-api.herokuapp.com/v2/
(e.g: https://coronavirus-tracker-api.herokuapp.com/v2/locations). You can try them out in your browser to further inspect responses.
We provide multiple data-sources you can pick from, simply add the query paramater ?source=your_source_of_choice
to your requests. JHU will be used as a default if you don't provide one.
-
jhu - https://github.com/CSSEGISandData/COVID-19 - Data repository operated by the Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE).
-
... more to come later.
GET /v2/latest
{
"latest": {
"confirmed": 197146,
"deaths": 7905,
"recovered": 80840
}
}
GET /v2/locations
{
"locations": [
{
"id": 0,
"country": "Thailand",
"country_code": "TH",
"province": "",
"last_updated": "2020-03-21T06:59:11.315422Z",
"coordinates": {
"latitude": "15",
"longitude": "101"
},
"latest": {
"confirmed": 177,
"deaths": 1,
"recovered": 41
}
},
{
"id": 39,
"country": "Norway",
"country_code": "NO",
"province": "",
"last_updated": "2020-03-21T06:59:11.315422Z",
"coordinates": {
"latitude": "60.472",
"longitude": "8.4689"
},
"latest": {
"confirmed": 1463,
"deaths": 3,
"recovered": 1
}
}
]
}
Additionally, you can also filter by country (alpha-2 country_code).
GET /v2/locations?country_code=US
Include timelines.
GET /v2/locations?timelines=1
GET /v2/locations/:id
{
"location": {
"id": 39,
"country": "Norway",
"country_code": "NO",
"province": "",
"last_updated": "2020-03-21T06:59:11.315422Z",
"coordinates": { },
"latest": { },
"timelines": {
"confirmed": {
"latest": 1463,
"timeline": {
"2020-03-16T00:00:00Z": 1333,
"2020-03-17T00:00:00Z": 1463
}
},
"deaths": { },
"recovered": { }
}
}
}
Exclude timelines.
GET /v2/locations?timelines=0
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.
These are the available API wrappers created by the community. They are not necessarily maintained by any of this project's authors or contributors.
You will need the following things properly installed on your computer.
git clone https://github.com/ExpDev07/coronavirus-tracker-api.git
cd coronavirus-tracker-api
pipenv shell
pipenv install
flask run
- Visit your app at http://localhost:5000.
make test
make lint
Thanks goes to these wonderful people (emoji key):
ExpDev ๐ป ๐ ๐ง |
bjarkimg ๐ฌ |
Bost ๐ |
GRIBOK ๐ป |
The data is available to the public strictly for educational and academic research purposes. Please link to this repo somewhere in your project :).