Home

Awesome

<p align="center"> <a href="https://nat236919.github.io/covid19-api/"><img src="https://i.ibb.co/Wg2yPBq/covid19-api-logo.png"></a> </p> <p align="center"> <em>API for exploring covid-19 cases around the globe powered by FastAPI framework</em> </p> <p align="center"> <a href="https://github.com/nat236919/covid19-api/issues" target="_blank"> <img src="https://img.shields.io/github/issues/nat236919/covid19-api" alt="issues"> </a> <a href="https://github.com/nat236919/covid19-api/network/members" target="_blank"> <img src="https://img.shields.io/github/forks/nat236919/covid19-api" alt="forks"> </a> <a href="https://github.com/nat236919/covid19-api/stargazers" target="_blank"> <img src="https://img.shields.io/github/stars/nat236919/covid19-api" alt="starts"> </a> <a href="https://github.com/nat236919/covid19-api/blob/master/LICENCE" target="_blank"> <img src="https://img.shields.io/github/license/nat236919/covid19-api" alt="licence"> </a> <a href="https://travis-ci.com/github/nat236919/covid19-api" target="_blank"> <img src="https://travis-ci.com/nat236919/covid19-api.svg?branch=master" alt="build"> </a> </p>

Introduction

This API provides the information regarding '2019 Novel Coronavirus (covid-19)'. It contains a number of confirmed, death, and recovered cases based on the data provided by the Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE).

Example

Applications

Reference

Branches

BranchFeatureDescription
masterDocker + Web APIFor deploying to a server
developmentDocker + Web APIFor testing before merging to Master

Features

  1. The current data (daily updated)
  2. Confirmed, Deaths, Recovered
  3. The affected countries
  4. Individual affected country
  5. Timeseries

How to Start a Server

uvicorn main:app

How to install (Docker-compose)

docker-compose up
docker-compose up -d
version: "3"
services:
  web:
    container_name: "covid19_api_web_container"
    volumes:
      - ./app:/app
    ports:
      - "80:80"
    environment:
      - "RUN=uvicorn main:app"

How to install (from Dockerhub)

docker pull nat236919/covid19-api:latest
docker run nat236919/covid19-api

How to use API (v2)

Check it out here

How to use API (v1)

Check it out here

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://nuttaphat.com"><img src="https://avatars0.githubusercontent.com/u/9074112?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nuttaphat Arunoprayoch</b></sub></a><br /><a href="#maintenance-nat236919" title="Maintenance">🚧</a> <a href="https://github.com/nat236919/covid19-api/commits?author=nat236919" title="Code">💻</a> <a href="https://github.com/nat236919/covid19-api/issues?q=author%3Anat236919" title="Bug reports">🐛</a> <a href="https://github.com/nat236919/covid19-api/commits?author=nat236919" title="Documentation">📖</a> <a href="https://github.com/nat236919/covid19-api/pulls?q=is%3Apr+reviewed-by%3Anat236919" title="Reviewed Pull Requests">👀</a></td> <td align="center"><a href="https://github.com/soapy1"><img src="https://avatars0.githubusercontent.com/u/976973?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sophia Castellarin</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=soapy1" title="Code">💻</a></td> <td align="center"><a href="https://keybase.io/endoffile78"><img src="https://avatars2.githubusercontent.com/u/11342054?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jeremy</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=endoffile78" title="Code">💻</a></td> <td align="center"><a href="https://github.com/ChooseYourPlan"><img src="https://avatars2.githubusercontent.com/u/32968964?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tim</b></sub></a><br /><a href="#translation-ChooseYourPlan" title="Translation">🌍</a></td> <td align="center"><a href="https://github.com/melsaa"><img src="https://avatars0.githubusercontent.com/u/32761948?v=4?s=100" width="100px;" alt=""/><br /><sub><b>melsaa</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=melsaa" title="Code">💻</a></td> <td align="center"><a href="https://github.com/owen-duncan-snobel"><img src="https://avatars.githubusercontent.com/u/43126781?v=4?s=100" width="100px;" alt=""/><br /><sub><b>owen-duncan-snobel</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=owen-duncan-snobel" title="Code">💻</a> <a href="https://github.com/nat236919/covid19-api/commits?author=owen-duncan-snobel" title="Documentation">📖</a> <a href="#financial-owen-duncan-snobel" title="Financial">💵</a></td> <td align="center"><a href="https://www.linkedin.com/in/maria-sitkovets-03994b159/"><img src="https://avatars.githubusercontent.com/u/28634142?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Maria Sitkovets</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=mSitkovets" title="Code">💻</a></td> </tr> <tr> <td align="center"><a href="https://github.com/aliraeisdanaei"><img src="https://avatars.githubusercontent.com/u/57504158?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ali Raeisdanaei</b></sub></a><br /><a href="https://github.com/nat236919/covid19-api/commits?author=aliraeisdanaei" title="Code">💻</a></td> </tr> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome!

Sponsor this project

<a href="https://www.buymeacoffee.com/HdYFLQU" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>