COVID-19 Data Tracking API

(0 reviews)

Retrieve Coronavirus (COVID-19) data that has been gathered and unified from trusted sources. This API is provided to the public by Salesforce, MuleSoft, and Tableau at no cost to help you make make better and faster decisions.

Summary

The COVID-19 Data Tracking API retrieves data from The New York Times, European CDC, and The COVID Tracking Project to provide COVID-19 case data based on the user-specified location. Users must specify a location and the number of days of data they want from the specific source. Read more to learn how to use the API

Are you thinking of using the COVID Data Tracking API in your projects? Let us know how so we can continue to improve the API

How to use the API

The location is either a Zip Code or a 2-letter ISO code for the country or US state.
If a Zip Code is provided, the returned information will be for the county to which the Zip Code belongs.
- If a Zip Code belongs to multiple counties, then, all the counties' information will be returned.
- If multiple Zip Codes are part of a county, all the associated Zip Codes within the same county will return the same information.
The days in the past must be up to the last 7 days. The user will receive up to 7 days of historic data from the current date.

NYT	ECDC	COVID Tracking
returns the date of data update	returns the date of data update	returns the date of data update
death count	death count	death count
reported infection count	reported infection count	reported infection count
recovery count	recovery count	recovery count
	active case count	active case count
		number of positive cases
		number of negative cases
		number of people in hospitals
		number of people in intensive care
		number of people intubated

Support: At this time, we only support the input of 1 location at a time.

Support: The Locations API Endpoint returns the most recently available data for the last 24 hours. If there is no data for that location, an HTTP status code of 404 is returned. The accompanying response body will be an empty object {}.

Support: The Cases API Endpoints do not display all the data over time. The data fetched will be from the last 7 days from the current date when the request is fired. The current date is in UTC. In the event, there is no data present for a particular date, additional data from the past will not be fetched.

This listing includes Coronavirus (COVID-19) data that has been gathered and unified from trusted sources, including the New York Times, the European CDC, and the COVID Tracking Project. This data is provided at no cost to help you make better and faster decisions.

The COVID Tracking Project- https://covidtracking.com/api/v1/states/current.json

The New York Times- https://github.com/nytimes/covid-19-data/blob/master/us-counties.csv

European Centre for Disease Prevention and Control- https://opendata.ecdc.europa.eu/covid19/casedistribution/json

Endpoints

Data Source	Application Endpoint
New York Times	https://localcoviddata.com/covid19/v1/locations?zipCode=13619
New York Times	https://localcoviddata.com/covid19/v1/cases/newYorkTimes?zipCode=13619&daysInPast=4
European CDC (EUCDC)	https://localcoviddata.com/covid19/v1/cases/eucdc?country=JP&daysInPast=4
CovidTracking.com	https://localcoviddata.com/covid19/v1/cases/covidTracking?state=CA&daysInPast=4

Throttling Limits

This API can support a large number of concurrent requests via a CDN. The origin API server will support up to 80 requests per second on production.

Environment	Limits
Production	80 requests per 1 second

Additional Resources:

Datasets included in this listing include:

* COVID-19 Data Tracking: A global time series of case and death data. This data is sourced from The New York Times (https://github.com/nytimes/covid-19-data), the European Centre for Disease Prevention and Control (https://www.ecdc.europa.eu/en/publications-data/download-todays-data-geographic-distribution-covid-19-cases-worldwide), and the COVID Tracking Project (https://covidtracking.com/data).

Visit the COVID-19 Data Hub (https://www.tableau.com/covid-19-coronavirus-data-resources), a free resource page, to learn more about these curated data sources and to access data visualizations, quick-start Tableau dashboards, and other partner-created solutions.

Regulatory and Compliance Information

For more information, refer to the linked source for each dataset included in this listing.

Disclaimer

These APIs are currently in beta and may be subject to change over the coming weeks.

home