Covid Tracking Project API

Beginner's Pick Health / No Auth Required Beginner HTTPS
Free to Use
88 A
Measured Score 0 50 100 Speed 28/30 Consistency 17/20 Security 20/20 Browser access 15/15 Transparency 8/15 TESTED 2026-08-10

Overview

The Covid Tracking Project API provides historical US Covid-19 data including tests, hospitalizations, and deaths at the state and national level. It is completely free with no API key required and returns data in JSON or CSV format. This is a great beginner API for practicing data analysis, building charts, or learning to work with time-series health data.

Beginner Tip

Note that the Covid Tracking Project stopped collecting data on March 7, 2021 — this API is a historical archive and will not return new data, making it ideal for data analysis exercises without worrying about live data freshness.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://api.covidtracking.com/v2/us/daily.json?limit=5
Result
HTTP 200 · application/json · 424,149 bytes · compressed
Response time
36 ms (median of 3) · fastest 32 ms
Transport
TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by Google Trust Services
Browser CORS
Allowed — Access-Control-Allow-Origin: *
Served by
cloudflare
Recorded
2026-08-10

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

track name and artist
album metadata
audio preview URLs
popularity score
genre classification
case counts and statistics

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "album": "A Night at the Opera",
  "duration_ms": 354000,
  "popularity": 92,
  "preview_url": "https://p.scdn.co/mp3-preview/..."
}

Field Reference

date Date in YYYYMMDD integer format (e.g. 20210307 for March 7, 2021).
states Number of US states and territories that reported data on this date.
positive Cumulative total of confirmed positive Covid-19 cases.
hospitalizedCurrently Number of people currently hospitalized with Covid-19 on this date.
death Cumulative total of deaths attributed to Covid-19.
totalTestResults Cumulative total of Covid-19 tests conducted.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://api.covidtracking.com/v2/us/daily.json?limit=5";
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.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist text/html
{
  "error": true,
  "message": "Data not found. Note that state codes in URLs should be lower case, for example, /api/v1/states/ca/info.json instead of /api/v1/states/CA/info.json."
}

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

Data appears frozen at March 2021 The Covid Tracking Project officially ended data collection on March 7, 2021.
This is expected behavior — the API is a historical dataset. For current data, use the CDC or state health department APIs.
404 Not Found for state endpoint The two-letter state code may be incorrect or uppercased differently than expected.
Use lowercase two-letter state codes in the URL, for example /v2/states/ca/daily.json for California.
Null values in response fields Some states did not report certain metrics (like ICU counts) consistently throughout the pandemic.
Handle null values in your code with fallback logic, as not all fields are guaranteed to be populated for every date.

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 28/30
Consistency 17/20
Security 20/20
Browser access 15/15
Transparency 8/15
Endpoint Response Time 36ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS NO
Category Health
Difficulty Beginner
Endpoint last called: 2026-08-10

Related Tags

Similar APIs

View All →