API is a free, open source data engineering & integration project written in JavaScript and released under GPL-3.0. It has 2,503 GitHub stars, 622 forks and 15 open issues, and was last pushed 7 months ago. On this registry it ranks #21 of 39 tracked projects in Data Engineering & Integration, with 5 head-to-head comparisons available.

What is API?

What it is

API is an open-source JavaScript service for disease statistics under GPL-3.0. It lives in the JavaScript data API ecosystem and publishes information about COVID-19, Influenza, and related disease tracking topics. The project gives users one API for global case overviews, city or region mobility data, and official government data for some countries.

The problem it solves is that COVID-19, coronavirus tracking, disease, and Influenza data are spread across government sources and outbreak reports. This project centralizes those facts behind an API, with documentation, a Postman collection, and a no-code path through databar.ai.

Key capabilities

  • It exposes disease-related statistics through an API, including COVID-19 global data overviews.
  • It provides city or region specific mobility data for coronavirus tracking.
  • It includes current outbreak information for Influenza.
  • It publishes official government data for some countries, as stated in the README.
  • It supports Redis-backed local deployment, with environment configuration for REDIS_HOST and related variables.
  • It offers a recommended JavaScript wrapper published on npm as novelcovid.
  • It provides a Postman collection and a no-code access route through databar.ai.

Who uses it and how

  • Developers use the public API or a self-hosted instance to retrieve COVID-19 and Influenza statistics for applications.
  • Data analysts and dashboard builders use the Postman collection to run requests against the API.
  • Non-code users access the data through the databar.ai platform instead of writing code.
  • Self-hosters fork the repository, configure .env, install dependencies with npm ci, and run the service with Redis or Docker.
  • Community contributors use the Discord server and the awesome-list showcase to share projects and support.

Getting started

Users can run the project locally with Redis and npm by cloning the repository, copying example.env to .env, running npm ci, and starting the service with npm run start:dev. Docker users can run npm run docker-start-dev for the local version or npm run docker-start for the published version.

When to use it — and when not to

Use this project when an open, JavaScript-based disease API is enough and when self-hosting is acceptable. The README lists no paid product it replaces, and a self-hoster must operate Redis, environment variables, and the application process or Docker setup. The README shows a four-person core team, 15 open issues, and a truncated source list, so users should check the source list and maintenance status before relying on it.

project readme (upstream, from github) — read inline

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

🐛

A

readme truncated — read the full docs on github

Frequently asked questions

Is API free to use?

API is open source under the GPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does API do?

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

What is API written in?

API is primarily written in JavaScript. Its source is publicly available at https://github.com/disease-sh/API, and it has 2,503 GitHub stars.