dianors / api

API for Current cases and more stuff about COVID-19 or the Novel Coronavirus Strain

Welcome to the NovelCOVID API

Information	Discord	Donate
This API provides a big range of detailed information about COVID19 from global data overviews to city/region specific mobility data. We also provide official government data for some countries, more to be added soon. The core-team currently consists of 4 people from 4 different countries working hard to keep this up and running, but it's an open-source project, so if you want, come help us

Check out our homepage and sign up for our newsletter here

Recommended by Postman

NovelCovid API is recommended by Postman here

Documentation

NovelCovid API Documentation can be found here

Installation

Without Docker

Redis

1. Download redis from https://redis.io/topics/quickstart
2. Start redis server using redis-server

Project

1. Fork and clone the git repository
2. In the new folder you will find a example.env file, duplicate it and rename it to .env only.
3. in the new .env file, change REDIS_HOST to localhost
4. Change the env variables to fit your environment (leave them blank for default values)
5. In one window run redis-server
6. In another window run npm run start:dev
7. Open your browser and navigate to localhost:{PORT} (PORT being the port specified in your .env file)
8. You should now see the APIs landing page

With docker-compose

1. Fork and clone the git repository
2. In the new folder you will find a example.env file, duplicate it and rename it to .env only.
3. Change the env variables to fit your environment (leave them blank for default values)
4. Run npm run docker-start-dev to run the local version of the API with Docker
5. Run npm run docker-start to run the published version of the API with Docker

Recommended Javascript Wrapper

• Github
• NPM

For further support, you can join our discord server! More Tutorials can be found there too! https://discord.gg/cEDxzfW

Showcases (Awesome-NovelCOVID)

Did you build a project with our API? We now offer an "awesome-list" for you to add your projects into so people can find out about them!

You can find it here.

Sources:

https://www.worldometers.info/coronavirus/

https://github.com/CSSEGISandData/COVID-19/tree/master/csse_covid_19_data/csse_covid_19_time_series

https://github.com/nytimes/covid-19-data

https://github.com/ActiveConclusion/COVID19_mobility

https://www.canada.ca/en/public-health/services/diseases/2019-novel-coronavirus-infection.html

https://github.com/pcm-dpc/COVID-19

https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Situationsberichte/Gesamt.html

https://info.gesundheitsministerium.at/

https://www.mohfw.gov.in/

https://covid19.ncdc.gov.ng/

https://github.com/openZH/covid_19/

https://coronavirus.data.gov.uk

Contributing

• How to Contribute

Contributors ✨

Thanks goes to these wonderful people (emoji key):

EliteDaMyth 💻	Ethan Winters 🐛	Himanshu Rathore 💻	apollyon600 📖	James Shelley 👀	Ryan Harlow 🐛	Ali Tas 🐛
Walter Corrales 💻	Ahmad Awais ⚡️ 📖	MrAugu 🐛	Ayyan Lewis 🐛	Ben Sommer 🐛 💻	Luis De Anda 📖	puf17640 💻
Oluka Denis 🐛	Kodjo Laurent Egbakou 📖

License