TL;DR
Disease.sh (formerly NovelCOVID) is an open-source API providing real-time disease outbreak data, primarily known for comprehensive COVID-19 statistics across all countries and US states. Beyond COVID-19, it also tracks monkeypox and other outbreaks. Data includes confirmed cases, deaths, recoveries, active cases, vaccination numbers, testing rates, and historical trends. All data is aggregated from official sources like WHO, CDC, ECDC, and Johns Hopkins University.
Quick start: https://disease.sh/v3/covid-19/all
No API key needed — just make a request!
How to Use This API
1. Global COVID-19 Totals
https://disease.sh/v3/covid-19/all
2. Statistics by Country
https://disease.sh/v3/covid-19/countries/Japan
3. US State Data
https://disease.sh/v3/covid-19/states/California
4. JavaScript — Global Stats Dashboard
fetch('https://disease.sh/v3/covid-19/all')
.then(r => r.json())
.then(d => {
console.log('Cases:', d.cases.toLocaleString());
console.log('Deaths:', d.deaths.toLocaleString());
console.log('Recovered:', d.recovered.toLocaleString());
console.log('Vaccinated:', d.updated);
});
5. Python — Compare Two Countries
import requests
for country in ['USA', 'India', 'Brazil']:
resp = requests.get(f'https://disease.sh/v3/covid-19/countries/{country}')
d = resp.json()
print(f"{country}: {d['cases']:,} cases, {d['deaths']:,} deaths")
https://disease.sh/v3/covid-19/all
API Details
- API URL
https://disease.sh/v3- Documentation
- disease.sh/docs
- Category
- Health
- Authentication
- Not Required
- Geographic Coverage
- Global — all countries and US states
Frequently Asked Questions
- Do I need an API key?
- No key required. Disease.sh is completely open and free for any use including commercial applications.
- How fresh is the data?
- Data is updated every 10-30 minutes from official sources including WHO, CDC, Johns Hopkins, and government health ministries.
- Can I get historical data?
- Yes, use the historical endpoints:
/v3/covid-19/historical/Canada?lastdays=30returns daily case/death counts for any period. - Does it include vaccination data?
- Yes, vaccine data is available at global, country, and state levels including doses administered, people vaccinated, and booster counts.
- Can I sort countries by cases?
- Use
/v3/covid-19/countries?sort=casesto get all countries sorted by confirmed cases, deaths, or active cases. - Does it cover outbreaks beyond COVID-19?
- Yes, there are endpoints for monkeypox data and the API framework can support other disease outbreaks as they emerge.
What You Can Build
- Live COVID-19 tracker dashboard with maps and charts
- Vaccination progress monitor by country
- Travel risk assessment tool showing outbreak levels
- Historical trend analyzer for epidemiological research
- News widget with regional outbreak statistics