Covid-19 JHU CSSE API

Beginner's Pick Health / No Auth Required Beginner HTTPS CORS

Free to Use Varies (check documentation)

92 A+

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The Covid-19 JHU CSSE API is a community-built REST API that exposes Johns Hopkins University's COVID-19 dataset in an easy-to-use JSON format. It provides global and country-level case counts, deaths, and recoveries without requiring any API key. No authentication is needed, making it one of the simplest COVID-19 APIs to start with.

Beginner Tip

Start with the /confirmed endpoint to get a quick sense of the data structure, then explore /deaths and /recovered for full pandemic statistics — all without any authentication.

Available Data

case counts and statistics

vaccination data

geographic breakdown

historical trend data

Example Response

JSON Response

{
  "status": "success",
  "data": {
    "result": "Data from Covid-19 JHU CSSE",
    "description": "Open-source API for exploring Covid19 cases based on JHU CSSE",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

countryRegion Name of the country or region.

confirmed Total cumulative confirmed COVID-19 cases.

deaths Total cumulative COVID-19 deaths.

recovered Total cumulative recovered cases.

active Active cases calculated as confirmed minus deaths and recovered.

lastUpdate ISO 8601 timestamp of the last data update.

Implementation Example

Request

const url = "https://nuttaphat.com/covid19-api/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Empty or stale response The API mirrors JHU data which is no longer actively updated since the university stopped its dashboard in 2023.

✓ Use this API for historical analysis only; for recent statistics consider alternative live sources.

Country name mismatch Country names in the dataset may differ from what you expect (e.g., 'US' instead of 'United States').

✓ Fetch the full country list first via /countries and match by the exact name string returned.

CORS error in browser fetch The community server may not include CORS headers for all browsers.

✓ Make requests from your backend server and relay results to the frontend to avoid CORS restrictions.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →