# disease-sh/API

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

Repository: https://github.com/disease-sh/API
Canonical: https://ross.abutalabs.com/products/disease-sh-api
Homepage: https://disease.sh
Language: JavaScript
License: GPL-3.0
License Family: copyleft
Topics: corona, covid19, api, covid, disease, redis, discord, postman, discord-server, cdc, covid-19, coronavirus, coronavirus-tracking
Last push: 2026-02-14T03:53:53+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 67, release rhythm 35, longevity 100
- inputs: {"age_days": 2372, "days_push": 200, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2503, forks 623 (observed 2026-08-28T04:06:57.041178+00:00)

## What it is
disease.sh is a free, open-source REST API serving JSON statistics on COVID-19, Influenza, and other disease outbreaks, aggregating data from multiple sources with automated updates. It is built in JavaScript (Node.js) with Redis caching and can be self-hosted via Docker or used through the hosted service.

## Use cases
- get current covid-19 case counts by country
- fetch historical covid-19 time series data
- query us state and county covid statistics
- get global influenza outbreak data
- retrieve covid-19 vaccine coverage statistics
- build a dashboard or widget showing pandemic stats
- self-host a disease statistics API

## When to choose
- you need free, no-auth JSON data on COVID-19 or influenza statistics
- you want multi-source, automatically updated outbreak data
- you need historical time series or vaccine data in one API
- you want to self-host the API with Docker and Redis

## When to avoid
- you need real-time or officially certified medical data for clinical use
- you need diseases beyond the supported outbreaks like COVID-19 and Influenza
- you require guaranteed SLAs or enterprise support

## Facets
- artifact type: service
- maturity: active
- function: http-server, caching, api-framework
- domain: healthcare, apis, data-science, analytics
- platform: self-hosted
- tags: covid-19, influenza, disease-data, public-api, epidemiology, rest-api, -api, redis-cache, nodejs, docker, web-server

## Member repositories
- disease-sh/API (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:57.041178+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:26:46.040044+00:00, confidence not recorded.
  - readme: https://github.com/disease-sh/API (fetched 2026-08-28T04:06:57.041178+00:00, sha 84473d2bf126)
  - homepage: https://disease.sh (fetched 2026-08-29T10:09:05.447585+00:00, sha 58e4819adbb3)
  - site_page: https://disease.sh/docs (fetched 2026-08-29T10:09:05.456360+00:00, sha b15924fdd163)
- Data as of 2026-08-30T08:39:29.467469+00:00.