# Welcome to disease.sh - An open API for disease-related statistics
| Information | Discord |
|:------------|:---------:|
| This API provides a big range of detailed information about multiple viruses. From COVID19 global data overviews to city/region specific mobility data, and data on the current outbreak of Influenza. 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!| [](https://discord.gg/cEDxzfW) |
**Check out** our homepage and **sign up** for our newsletter [here](https://disease.sh/)
## Recommended by Postman
Disease.sh is recommended by Postman [here](https://covid-19-apis.postman.com/)
[](https://app.getpostman.com/run-collection/11144369-e27366d6-7699-46f4-b58e-2b2b2e637be5-Szf6Z9B3)
## Run through [databar.ai](https://databar.ai)
If you don't know how to use APIs, you can use disease.sh without code through the [databar.ai](https://databar.ai) platform.
[](https://databar.ai/explore/open-disease-data-api?utm_source=diseasesh&utm_campaign=apiref)
## Documentation
Disease.sh Documentation can be found [here](https://disease.sh/docs/)
# 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)
6. In one window run `redis-server`
7. Run `npm ci` to install the packages
8. In another window run `npm run start:dev`
9. Open your browser and navigate to `localhost:{PORT}` (PORT being the port specified in your `.env` file)
10. 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](https://github.com/disease-sh/node-api)
- [NPM](https://npmjs.com/novelcovid)
> 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
> https://covid19.go.id
> https://datadashboard.health.gov.il/COVID-19/general
# Contributing
- [How to Contribute](./CONTRIBUTING.md)
# Contributors β¨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
