corona-api
used in : https://corona-visuals.now.sh/ (https://github.com/adhambadr/corona-visual-tool)
Simple REST api for getting live Covid-19 confirmed, recovered and deaths.
Data is piggybacked from morgenpost.de live tracker, which runs a web scraper scraps from Johns Hopkins University CSSE, WHO, CDC (USA), ECDC (Europa), NHC, DXY (China) and the official German Health ministry (Robert-Koch-Institut and German Federal Health Institute).
To avoid bashing ther servers data is updated only every 15 minutes and cached localy. Most institutes update records within a 3-6 hour window so no need for any higher frequency of querying
API
| Method | Path | Query | Result |
|---|---|---|---|
| GET | / | Data for world numbers (confirmed , recovered, deaths) | |
| GET | /current | ?country=Spain | data for country (obj description below) |
| POST | /current/location | {longitude : 5.1232 , latitude : -7.2321 } | simple geo nearest data point for given location |
| GET | /historic | ?country=USA | historic data points up till now |
Result object
/
{
"confirmed": 157002,
"recovered": 73971,
"deaths": 5833
}/current?country=Mexico
{
"parent": "global",
"label": "Mexiko",
"updated": 1584219182000,
"date": "2020-03-14T20:53:02.000Z",
"confirmed": 26,
"recovered": 4,
"deaths": 0,
"lon": -102.5528,
"lat": 23.6345,
"source": "Coronavirus COVID-19 Global Cases by Johns Hopkins CSSE",
"source_url": "https://www.arcgis.com/apps/opsdashboard/index.html#/bda7594740fd40299423467b48e9ecf6",
"scraper": "hopkins.arcgis",
"statesData": []
}Few countries have state based data (Germany, China, USA, Italy) i reckon
/current/location
Returns either same country object as /current result or if it finds a state level data point it will return :
{
"parent": "Deutschland",
"label": "Berlin",
"updated": 1584259200000,
"date": "2020-03-15T08:00:00.000Z",
"confirmed": 263,
"recovered": 0,
"deaths": 0,
"lon": 13.40732,
"lat": 52.52045,
"source": "RKI/eigene",
"source_url": "https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Fallzahlen.html",
"scraper": "rki.spreadsheet",
"countryData": {
"confirmed": 5178,
"recovered": 48,
"deaths": 9,
"statesData": []
}
}
.../history?country=France
returns keyed object with all the datapoints since cases tracking, key being State name + a federal key for a combined list of data points
{ "Saint Barthélemy" : [...] , /* Same result object as above */ "federal": [ { "date": "2020-03-04T00:00:00.000Z", "confirmed": 3, "recovered": 0, "deaths": 0 }, ... ] }
Development
Install
Run
Happy data playing.