COVID-19-API

API Service for tracking the COVID-19

Try it

API Document

Recovered data from JHU CCSE will not be updated after March 23th. Check this issue.

Endpoint

https://master-covid-19-api-laeyoung.endpoint.ainize.ai/

Brief

Request:

GET /jhu-edu/brief

Successful Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
	"confirmed": 7783,
	"deaths": 170,
	"recovered": 133
}

Curl:

curl -X GET "https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/brief" -H "accept: application/json"

Browser: https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/brief

Latest

Request:

GET /jhu-edu/latest

Options

• Filter by country's iso2 or iso3 code

GET /jhu-edu/latest?iso2=US

• Make the sum of all the cities or the states in those countries

GET /jhu-edu/latest?onlyCountries=true

You can uses both options together.

Successful Response:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "provincestate": "Anhui",
    "countryregion": "Mainland China",
    "lastupdate": "2020-02-29T07:21:21.001Z",
    "confirmed": 990,
    "deaths": 6,
    "recovered": 821,
    "location": {
      "lat": 31.8257,
      "lng": 117.2264
    },
    "countrycode": {
      "iso2": "CN",
      "iso3": "CHN"
    }
  }, {
    "provincestate": "Beijing",
    "countryregion": "Mainland China",
    "lastupdate": "2020-02-29T07:21:21.001Z",
    "confirmed": 410,
    "deaths": 7,
    "recovered": 257,
    "location": {
      "lat": 40.1824,
      "lng": 116.4142
    },
    "countrycode": {
      "iso2": "CN",
      "iso3": "CHN"
    }
  }, ...
]

Curl:

curl -X GET "https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/latest" -H "accept: application/json"

Browser:

• https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/latest
• https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/latest?iso2=US&onlyCountries=true

Timeseries

Request:

GET /jhu-edu/timeseries

Options

• Filter by country's iso2 or iso3 code

GET /jhu-edu/timeseries?iso2=US

• Make the sum of all the cities or the states in those countries

GET /jhu-edu/timeseries?onlyCountries=true

You can uses both options together.

Successful Response:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "provincestate": "Anhui",
    "countryregion": "Mainland China",
    "lastupdate": "2020-02-29T08:15:03.208Z",
    "location": {
      "lat": 31.8257,
      "lng": 117.2264
    },
    "countrycode": {
      "iso2": "CN",
      "iso3": "CHN"
    },
    "timeseries": {
      "1/22/20": {
        "confirmed": 1,
        "deaths": 0,
        "recovered": 0
      },
      "1/23/20": {
        "confirmed": 9,
        "deaths": 0,
        "recovered": 0
      }, ...
    }
  }, {
    "provincestate": "Beijing",
    "countryregion": "Mainland China",
    "lastupdate": "2020-02-29T08:15:03.208Z",
    "location": {
      "lat": 40.1824,
      "lng": 116.4142
    },
    "countrycode": {
      "iso2": "CN",
      "iso3": "CHN"
    },    
    "timeseries": {
      "1/22/20": {
        "confirmed": 14,
        "deaths": 0,
        "recovered": 0
      },
      "1/23/20": {
        "confirmed": 22,
        "deaths": 0,
        "recovered": 0
      }, ...
    }
  }, ...
]

Curl:

curl -X GET "https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/timeseries" -H "accept: application/json"

Browser:

• https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/timeseries
• https://master-covid-19-api-laeyoung.endpoint.ainize.ai/jhu-edu/timeseries?iso2=US&onlyCountries=true

Services using COVID-19-API

• https://corona-board.soaple.endpoint.ainize.ai/
• https://wordpress.org/plugins/corona-virus-data/ (WordPress plugin)
• https://corona-three.now.sh/

Original data source

• Novel Coronavirus (COVID-19) Cases, provided by JHU CSSE
• Live Corona Detector, provided by KCDC(South Korea)

License

This project is released under the MIT License. See LICENSE for details.

Terms of Use

You can uses this Repo and API service freely, even commercial uses. But this term of use rely on data sources. You have to check each terms of use of data sources (JHU CSSE, livecod(kor)).