Skip to content

pillious/Covid-19-Api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 

Repository files navigation

Covid-19 Api

Global COVID-19 data (free to use). - latest data: Aug. 16, 2020

Find me on RapidAPI

Usage:

Get the most recent report's data

https://covid19.pillious.now.sh/api/data

Utility endpoints

Valid country and territory names: /api/data/names
Valid region names: /api/data/regions
Description of transmission types: /api/data/transmissionTypes

Filter parameters


Parameter Type Description
name String Search by a country or territory name (supports only one name at a time).
region String Defined regions:
  • Western Pacific Region
  • European Region
  • SouthEast Asia Region
  • Eastern Mediterranean Region
  • Region of the Americas
  • African Region
territory Boolean Limit search to only countries or territories.
(true - territories only, false - countries only)
reportDate String Get data for a single day
(format: YYYY-MM-DD)
reportNumber Integer Similar to reportDate, each report has a report number attached.
cases Integer Limit search to n number of total confirmed cases and above.
newCases Integer Limit search to n number of new confirmed cases (since the previous report) and above.
deaths Integer Limit search to n number of total confirmed deaths and above.
newDeaths Integer Limit search to n number of new confirmed deaths (since the previous report) and above.
transmissionType Integer Search by a specific type of transmission (as defined by WHO). *
  • 0 = Community transmission
  • 1 = Local transmission
  • 2 = Imported cases only
  • 3 = Under investigation
  • 4 = Interrupted transmission
  • 5 = Sporadic cases
  • 6 = Cluster of cases
  • 7 = No cases

* Descriptions for each transmission type found HERE.

Api Updates

6/19/20:

  • New transmissionType added (No cases)
  • If no query params are provided, /api/data returns data for the most recent report (originally returned data for every report)

Response example

https://covid19.pillious.now.sh/api/data?region=European%20Region&cases=35000&reportDate=2020-03-25

[
  {
    "name":"Italy",
    "cases":69176,
    "newCases":5249,
    "deaths":6820,
    "newDeaths":743,
    "transmissionType":1,
    "daysSinceLastCase":0,
    "region":"European Region",
    "territory":false,
    "reportDate":"2020-03-25T00:00:00.000Z",
    "reportNumber":65
  },
  {
    "name":"Spain",
    "cases":39673,
    "newCases":6584,
    "deaths":2696,
    "newDeaths":514,
    "transmissionType":1,
    "daysSinceLastCase":0,
    "region":"European Region",
    "territory":false,
    "reportDate":"2020-03-25T00:00:00.000Z",
    "reportNumber":65
    }
  ]


data aquired from The World Health Organization.

Keywords: Coronavirus, COVID-19, API, JSON data

Releases

No releases published

Packages

 
 
 

Contributors