Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Laeyoung/COVID-19-API

API Service for tracking the COVID-19
https://github.com/Laeyoung/COVID-19-API

ainize api-server corona covid-19 swagger swagger-api

Last synced: 9 days ago
JSON representation

API Service for tracking the COVID-19

Host: GitHub
URL: https://github.com/Laeyoung/COVID-19-API
Owner: Laeyoung
License: mit
Created: 2020-01-29T13:16:57.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-03-28T02:09:04.000Z (8 months ago)
Last Synced: 2024-08-02T14:08:36.690Z (3 months ago)
Topics: ainize, api-server, corona, covid-19, swagger, swagger-api
Language: JavaScript
Homepage: https://ainize.ai/laeyoung/covid-19-api
Size: 962 KB
Stars: 122
Watchers: 10
Forks: 32
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# COVID-19-API [![Docker Pulls](https://img.shields.io/docker/pulls/laeyoung/wuhan-coronavirus-api?style=plastic)](https://hub.docker.com/r/laeyoung/wuhan-coronavirus-api/) [![Total alerts](https://img.shields.io/lgtm/alerts/g/Laeyoung/COVID-19-API.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Laeyoung/COVID-19-API/alerts/)

API Service for tracking the COVID-19

## Try it
[![Run on Ainize](https://ainize.ai/images/run_on_ainize_button.svg)](https://ainize.web.app/redirect?git_repo=https://github.com/laeyoung/covid-19-api)

## API Document

>Recovered data from JHU CCSE will not be updated after March 23th. Check [this issue](https://github.com/Laeyoung/COVID-19-API/issues/16).

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

### Brief

**Request:**
```json
GET /jhu-edu/brief
```
**Successful Response:**
```json
HTTP/1.1 200 OK
Content-Type: application/json

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

**Curl:**
```sh
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:**
```json
GET /jhu-edu/latest
```

Options
- Filter by country's iso2 or iso3 code
```json
GET /jhu-edu/latest?iso2=US
```
- Make the sum of all the cities or the states in those countries
```json
GET /jhu-edu/latest?onlyCountries=true
```
You can uses both options together.

**Successful Response:**
```json
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:**
```sh
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:**
```json
GET /jhu-edu/timeseries
```

Options
- Filter by country's iso2 or iso3 code
```json
GET /jhu-edu/timeseries?iso2=US
```
- Make the sum of all the cities or the states in those countries
```json
GET /jhu-edu/timeseries?onlyCountries=true
```
You can uses both options together.

**Successful Response:**
```json
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:**
```sh
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](https://github.com/CSSEGISandData/COVID-19), provided by JHU CSSE
- [Live Corona Detector](https://github.com/LiveCoronaDetector/livecod), provided by KCDC(South Korea)

## License
This project is released under the [MIT License](http://opensource.org/licenses/MIT). 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](https://github.com/CSSEGISandData/COVID-19/blob/master/README.md), [livecod(kor)](https://github.com/LiveCoronaDetector/livecod/blob/master/README.md)).