API for exploring covid-19 cases around the globe powered by FastAPI framework

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

• https://covid19api.azurewebsites.net/
• https://covid2019-api.herokuapp.com/

Applications

• Coronavirus App by YaseenAbdullah
• Covid 19 App - Map, info & help by DavidBarbaran
• COVID-19 Visual Explorer by FitnessAI
• BAILAM (Data and API Integration)
• Coronavirus Tech Handbook (Data Tools)

Reference

• https://github.com/CSSEGISandData/COVID-19

Branches

Branch	Feature	Description
master	Docker + Web API	For deploying to a server
development	Docker + Web API	For 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

• Go to app directory and Run the following command in your command line to start a server

uvicorn main:app

How to install (Docker-compose)

• Run the following command in your command line to run the server

docker-compose up

• Or run the server in the background

docker-compose up -d

• The port can be changed at docker-compose.override.yml

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)

• Download the latest image

docker pull nat236919/covid19-api:latest

• Create a container and run

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):

Nuttaphat Arunoprayoch 🚧 💻 🐛 📖 👀	Sophia Castellarin 💻	Jeremy 💻	Tim 🌍	melsaa 💻	owen-duncan-snobel 💻 📖 💵	Maria Sitkovets 💻
Ali Raeisdanaei 💻

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

Sponsor this project