Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/disease-sh/api

API for Current cases and more stuff about COVID-19 and Influenza
https://github.com/disease-sh/api

api cdc corona coronavirus coronavirus-tracking covid covid-19 covid19 discord discord-server disease postman redis

Last synced: about 16 hours ago
JSON representation

API for Current cases and more stuff about COVID-19 and Influenza

Host: GitHub
URL: https://github.com/disease-sh/api
Owner: disease-sh
License: gpl-3.0
Created: 2020-03-05T05:28:12.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-08-01T16:01:58.000Z (6 months ago)
Last Synced: 2025-01-30T04:20:20.545Z (about 17 hours ago)
Topics: api, cdc, corona, coronavirus, coronavirus-tracking, covid, covid-19, covid19, discord, discord-server, disease, postman, redis
Language: JavaScript
Homepage: https://disease.sh
Size: 4.32 MB
Stars: 2,462
Watchers: 75
Forks: 633
Open Issues: 8
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md

Awesome Lists containing this project

README

        ![Logo](./public/assets/img/icon-long.png)





![DockerHub Downloads](https://img.shields.io/docker/pulls/novelcovid/novelcovid-api?style=for-the-badge)

![GitHub contributors](https://img.shields.io/github/contributors-anon/disease-sh/api?style=for-the-badge)

![ESLint](https://img.shields.io/github/workflow/status/disease-sh/API/Eslint?label=ESLint&style=for-the-badge)

![Tests](https://img.shields.io/github/workflow/status/disease-sh/API/Unittest?label=Tests&style=for-the-badge)

![GitHub top language](https://img.shields.io/github/languages/top/disease-sh/api?style=for-the-badge)

![GitHub issues](https://img.shields.io/github/issues/disease-sh/api?style=for-the-badge)

![GitHub closed issues](https://img.shields.io/github/issues-closed/disease-sh/api?style=for-the-badge)

![GitHub pull requests](https://img.shields.io/github/issues-pr/disease-sh/api?style=for-the-badge)

![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/disease-sh/api?style=for-the-badge)

![Visits](https://badges.pufler.dev/visits/disease-sh/api?style=for-the-badge)

# 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](https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fimg.icons8.com%2Fcolor%2F2x%2Fdiscord-logo.png&f=1&nofb=1)](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/)

[![Run in Postman](https://run-beta.pstmn.io/button.svg)](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.

[![Run without code](https://databar.ai/external/ref_button.svg)](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)):

  

    
_{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](https://app.fossa.io/api/projects/git%2Bgithub.com%2FNovelCOVID%2FAPI.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FNovelCOVID%2FAPI?ref=badge_large)