Skip to content

disease-sh/API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Logo

DockerHub Downloads GitHub contributors ESLint Tests GitHub top language GitHub issues GitHub closed issues GitHub pull requests GitHub closed pull requests Visits

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!
Discord server

Check out our homepage and sign up for our newsletter here

Recommended by Postman

Disease.sh is recommended by Postman here

Run in Postman

Run through databar.ai

If you don't know how to use APIs, you can use disease.sh without code through the databar.ai platform.

Run without code

Documentation

Disease.sh 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. Run npm ci to install the packages
  7. In another window run npm run start:dev
  8. Open your browser and navigate to localhost:{PORT} (PORT being the port specified in your .env file)
  9. 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

Version Size Downloads

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

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Ethan Winters

πŸ›

Julian Pufler

πŸ’»

Himanshu Rathore

πŸ’»

apollyon600

πŸ“–

James Shelley

πŸ‘€

Ryan Harlow

πŸ›

Ali Tas

πŸ›

Walter Corrales

πŸ’»

Ahmad Awais ⚑️

πŸ“–

MrAugu

πŸ›

Ayyan Lewis

πŸ›

Ben Sommer

πŸ› πŸ’»

Luis De Anda

πŸ“–

Oluka Denis

πŸ›

Kodjo Laurent Egbakou

πŸ“–

Juan SebastiΓ‘n Marulanda SΓ‘nchez

πŸ’»

Collin-St

πŸ’»

MarvelDC

πŸ“–

Zentreaxᴰᡉᡛ

πŸ’»

comster

πŸ’»

License

FOSSA Status