mathdroid/covid-19-api

COVID-19 global data (from JHU CSSE for now) as-a-service

[](#contributors-)

COVID-19 API

No longer maintaining the official deployment. Please fork this repo and use it for your own purpose.

Serving data from John Hopkins University CSSE as a JSON API

Routes

• /: contains opengraph image for sharing

• /api: global summary

• /api/og: generate a summary open graph image

• /api/confirmed: global cases per region sorted by confirmed cases

• /api/recovered: global cases per region sorted by recovered cases

• /api/deaths: global cases per region sorted by death toll

• /api/daily: global cases per day

• /api/daily/[date]: detail of updates in a [date] (e.g. /api/daily/2-14-2020)

• /api/countries: all countries and their ISO codes

• /api/countries/[country]: a [country] summary (e.g. /api/countries/Indonesia or /api/countries/USA or /api/countries/CN)

• /api/countries/[country]/confirmed: a [country] cases per region sorted by confirmed cases

• /api/countries/[country]/recovered: a [country] cases per region sorted by recovered cases

• /api/countries/[country]/deaths: a [country] cases per region sorted by death toll

• /api/countries/[country]/og: generate a summary open graph image for a [country]

Usage

1. Clone

   git clone --depth=1 https://github.com/mathdroid/covid-19-api

2. Install deps (yarn, npm install)

3. Install and register to ZEIT Now if you haven't. This project is exclusively made for the platform.

4. now dev to run a local dev deployment, now to publish.

Showcase

• Create a Github Action that Send Everyday Covid19 Status Through Telegram Using Python, (Telegram Bot) by catflip

• 17 responsible live visualizations about the coronavirus, for you to use, (Web) by Datawrapper

• Android kotlin-mvvm-covid19, (Android) by Rizki Maulana

• CovidNow, (Android) by Oskar Misiewicz

• https://github.com/andreyyoshua/Covid-19, (iOS) by Andrey Yoshua

• https://github.com/pararang/vue-covid, (VueJS) by Muhammad Ikhsan

• Vue Covid 19 monitoring App, (VueJS) by Mahmud Rafid . A demo.

• https://github.com/pooladkhay/covid19, (React, NextJS) by Mohammad Javad Pooladkhay

• https://github.com/alancampora/corona-virus-react, (React) by Alan Adrian Campora

• https://github.com/alankilalank/react-covid-19, (React, CRA) by Alank Ilalank

• https://github.com/pabloVinicius/covid-19-dashboard https://covid19.data.eti.br/, (Web) by Pablo Vinicius

• https://github.com/freakyfelt/gatsby-source-mathdroid-covid19(https://github.com/freakyfelt/gatsby-source-mathdroid-covid19), (Gatsby, TypeScript) by Bruce Felt

• https://github.com/miftahafina/covid19-data, (React) by Miftah Afina

• https://github.com/mazik/corona/, (An Electron based Desktop application based on VueJS) by Md Mazedul Islam Khan

• https://github.com/hoaaah/flutter-covid19ina, (Flutter) by @hoaaah

• https://github.com/kasramp/COVID-19-Telegram-bot, (Telegram Bot, Java) by Kasra Madadipouya

• https://covid-19-map.netlify.com/,(React, Deck.GL) by Jason Feng

• https://github.com/Ghazif-Adeem/COVID-19-Statistics-Checker, (PHP) by Ghazif Adeem

• Access mathdroid API to store Coronavirus COVID-19 worldwide data in JSON format, (Javascript script, get updated every 8 hours by Github Actions) by Maxine Chen

• A Coronavirus COVID-19 global data statistics website, (React + Gatsby + Material UI + Recharts) by Maxine Chen

• https://novel-coronavirus-reports.netlify.com/, (PWA with Map & reports) by Sharad Raj Singh Maurya

• https://github.com/sutanlab/covid19-visualized, (Next.js, TypeScript) by Sutan Gading F. Nasution

• A Dedicated Covid-19 Philippines Tracker, (React, CRA, TailwindCSS) by Mark Anthony Uy

• Covid-19 World Map (D3.js globe displaying confirmed, recovered, and death counts by country) by Paige Vogenthaler

• https://souryvath.github.io/ng-covid-19/, (Angular, ApexCharts) by Souryvath NIRASAY

• Corona-tracker, (Vue frontend for the API with main focus on India) by Akash Raju M

• https://github.com/satyawikananda/Vucovid-Covid-info, (VueJS, PWA) by Satya Wikananda

• https://github.com/juanitourquiza/ng-covid-19 https://hackeruna.com/covid19/, (Angular) by Juan Urquiza

• RN-Covid19, (React-Native) by Hamaar

• Last 7 days chart with percentages,(Next, React, PWA) by Mithhu

• https://livecovid19stats.netlify.com, (Gatsby, React) by Dhaiwat Pandya

• https://corona-stats-eta.now.sh/, (React, Hooks) by Vitor Boccio

• COVID-19 | Coronavirus Live Stats and Tracker, (React) by Micah Mones

• https://sandipnirmal.github.io/covid-19-tracker, (React PWA) by Sandip R. Nirmal

• https://github.com/NoumanHere/COVID-19-Using-Django, (Django, Python) by Nouman

• https://github.com/mazik/corona-tracker/, (A Google Chrome extension for tracking CORONAVIRUS - COVID-19 update) by Md Mazedul Islam Khan

• https://github.com/johanneshaberlah/corona-dashboard, (Java, Spring) by Johannes Haberlah

• https://krishnatre-siddhartha.github.io/, (HTML+JS) by Siddhartha Sharma

• Corona Count, (Next.js) by Ankit Suraj

• https://github.com/NicolaLisci/COV1D9, (Angular 9, Typescript) by Nicola Lisci DEMO

• https://mzaini30.js.org/covid19. Source: https://github.com/mzaini30/covid19/. By: @mzaini30

• https://github.com/oniharnantyo/covid-19-telegram-bot, (Telegram Bot, Golang) by Oni Harnantyo

• https://github.com/dabigjoe6/react-native-covid19, (React Native) by Joseph Olabisi

• https://fight-covid19.netlify.app/, (Gatsby, React) by Jason Zheng

• https://github.com/mastersam07/toju_wa, (Flutter) by @Mastersam07

• https://github.com/flborrelli/covid-19-updates, (React + Semantic UI) by Fernando Lima Borrelli

• covid19-graphql-api.herokuapp.com, (GraphQL) by Rene Osman

• http://corona.milestonetechs.com/ by omarjamal1

• https://coronnavirusapp.firebaseapp.com/, (Angular/Ionic) by Rayden2015

• https://github.com/melvinalmonte/covid-bot, (Chatbot using Google's Dialogflow + NextJS Wrapper) by Melvin Almonte

• https://cdmoro.github.io/covid-19-stats/ https://github.com/cdmoro/covid-19-stats React, by cdmoro

• https://tracking-corona.web.app/ https://github.com/JakMar17/CoronaTracker by JakMar17

• https://covid19site.netlify.com/ (Vue.js) by Ihsan Nurul Habib

• https://github.com/ihsaninh/covid-19-reactnative, (React Native) by Ihsan Nurul Habib

• https://github.com/AbdullahChauhan/Coronavirus-COVID-19-Tracker, (Flutter) by Abdullah Chauhan

• https://github.com/dynamicbalaji/covid19-tracker, (React) by Balaji Ashok Kumar(BK)

• https://covid19.sznm.dev, (Gatsby, Nivo) by Agustinus Nathaniel

• https://github.com/ZuTechV2/c19stats, https://zu-c19stats.netlify.app, (VueJS) by Zu Tech V2

License

MIT License 2020, mathdroid.

Transitively from the Johns Hopkins Site, the data may not be used for commercial purposes.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Odi 💻 📖

Yahya Fadhlulloh Al-Fatih 💻

spiritbro1 💻

Imperial Owl 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

covid-19-api's Issues

global cases per region sorted by confirmed cases (api/confirmed)

fetch request from e.g. https://covid19.mathdro.id/api/countries/us
--> confirmed cases can be accessed by data.confirmed.value

Wanting to create a table of countries sorted by confirmed death cases...
how can i access the endpoints from https://covid19.mathdro.id/api/confirmed ?

Thanks!

World Daily info seem missing recovered data

World Daily info seem missing recovered
https://covid19.mathdro.id/api/daily

{"totalConfirmed":337091,"mainlandChina":81435,"otherLocations":255656,"deltaConfirmed":0,"totalRecovered":0,"confirmed":{"total":337091,"china":81435,"outsideChina":255656},"deltaConfirmedDetail":{"total":0,"china":0,"outsideChina":0},"deaths":{"total":14651,"china":3274,"outsideChina":11377},"recovered":{"total":0,"china":0,"outsideChina":0},"active":0,"deltaRecovered":0,"incidentRate":0,"peopleTested":0,"reportDate":"2020-03-22"}]

Days till 1 million Cases

I created a web app using Flask , some regression and your API. Just wanted to showcase it here.

https://github.com/stealthanthrax/corona-ml-corona
https://days-till-mill.netlify.com/

Stay safe guys :)

Add method for daily cases by country, by date

Suggested form: /api/countries/[country]/daily/[date]

Alternatively: /api/daily/[date]/countries/[country]

Sorting cases by country

I'm trying to extract a list of confirmed cases by country using the endpoint .../api/confirmed. All countries except China and the United States seem to have their own entry. Can this endpoint be modified to include China and US totals so that I can access these totals without having to make a separate request or doing a reduce on the regional data?

Cumulative regional data doesn't match reported totals for country

I wrote a python script to fetch data by regions for a single country and added the totals. The hope was to visualize daily totals for a country. Unfortunately, I get completely different results than the reported daily totals for the country leading me to believe that the data is inaccurate. Any insight on this would be helpful.

Exception when attempting to access API within a Java package.

In my instance, I am unable to disable SSL checks in the application I am building. Because of this, I keep getting an error because Java doesn't like the SSL certificate for some reason. The full error can be found below:

sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Daily info for countries

Does the CSSE publish, and if it does, would it be possible, to get the daily info for smaller countries as well? For example, Estonia?

Florida Data is missing

Hi there I'm noticing since last night Florida, US data is missing in the response

duplicate country ISO code

Hello there, thanks for this interesting API, there seems to be duplicate ISO codes for these countries.
{
"China": "CN",
"Mainland China": "CN",
"Czech Republic": "CZ",
"Czechia": "CZ"
}

Image api has CORB issue

I tried using the app and api. I wanted to add the dynamic image which is returned from this url.
https://covid19.mathdro.id/api/og

But this image is blocked by browser with CORB error.
can you add respective CORS policy in the api. thanks!

Negative numbers for recovered and deaths

In some cases the API is returning negative numbers for Recovered and Deaths.
So, I am not sure if I should assume a "recovered: -1" means +1 death.

why deaths value 0?

Null data (0)

As of right now I was making something using this api it was all working fine, but now it is returning null data (0) everything is zero.

Hopefully this gets fixed asap as this is the best api for coronavirus cases I have seen!

incorrect data

A request made to

GET /api/countries/canada HTTP/1.1
Host: covid19.mathdro.id
User-Agent: python-requests/2.23.0
Accept-Encoding: gzip, deflate
Accept: /
Connection: close

showing this that is inaccurate

{
"confirmed": {
"value": 0,
"detail": "https://covid19.mathdro.id/api/countries/canada/confirmed"
},
"recovered": {
"value": 0,
"detail": "https://covid19.mathdro.id/api/countries/canada/recovered"
},
"deaths": {
"value": 0,
"detail": "https://covid19.mathdro.id/api/countries/canada/deaths"
},
"lastUpdate": "2020-03-18T19:39:34.436Z"
}

Country data outside of US not available

Looks like none of these endpoints are currently working:

https://covid19.mathdro.id/api/countries/CA
https://covid19.mathdro.id/api/countries/CN
https://covid19.mathdro.id/api/countries/Indonesia

Are they currently down?

Thanks for making this!

Indonesia data is outdated

{"error":{"message":"Country `ye` not found in JHU database"}}

Add deaths to api/daily

Hey, thanks for your service. Why is the "death" variable not part of the endpoint covid.mathdro.id/api/daily?

I only see total confirmed and total recovered. Would it be possible to integrate deaths as well? Thank you!

Returning 0 as response

When sending the request I get a response everything in 0. It was working fine 2 hours ago, but not working now. Looks like the API is having some issues.

Data is not refreshed since yesterday

Thank you for creating this API!! I am building react app to show stats. realized that numbers are not updated since yesterday night (US time). e.g. total number is 156400 for last almost last 10+ hrs. Thanks!

Usage

Hi,

Can we use the api in our free apps.

Thanks

Add country code to response

Can you provide the country code in response (like CHN, SPN, USA, etc)? Since i need to match your country data with our country list.

Here are example of non-standard country name:

• Mainland China
• US
• etc

Thanks!

not found in jhu db

request url: https://covid19.mathdro.id/api/countries/TKL
response: {"error":{"message":"Country TKL not found in JHU database"}}

Data is not refreshing

Is there any problem? Data is not refreshing for 7-8 hours

No data for Taiwan

Hey there, thanks for this project.

Data for Taiwan seems to be missing, even if available here.

Here the endpoint returning all zeros: covid19.mathdro.id/api/countries/TW

timelines query

could you add a "timelines" query? in order to see the history of the last days pls

Usage

Hi,

Please guide me can we use inside our app. We are developing a free app for the users

Last updated on daily report

Thank you for this API.

I am wondering if you can have a small lastupdated in the endpoint for the daily report.

Fixes to country names

Hey,

There are multiple instances of records where country names are different:

{
    "Mainland China": "China",
    "Republic of Korea": "South Korea",
    "Korea, South": "South Korea",
    "Hong Kong SAR": "Hong Kong",
    "Iran (Islamic Republic of)": "Iran",
    "Republic of Ireland": "Ireland",
    "Republic of Moldova": "Moldova",
    "Macao SAR": "Macau",
    "Taiwan*": "Taiwan",
    " Azerbaijan": "Azerbaijan",
    "Russian Federation": "Russia",
    "Congo (Brazzaville)": "Republic of the Congo",
    "Congo (Kinshasa)": "Democratic Republic of the Congo",
    "occupied Palestinian territory": "Palestine"
}

just FYI

all data is in 0

yesterday it was good today the dont show nothing 0 values

South Korea not found in JHU database

South Korea endpoint returns an error "not found in JHU database":

https://covid19.mathdro.id/api/countries/KR
https://covid19.mathdro.id/api/countries/KOR

Bitbar plugin

Hello, i built an bitbar plugin using your api if you want to share :)
https://github.com/elalemanyo/bitbar-covid-19-tracker

Thank you for your awesome work :)

South Korea seems to be duplicated

Hello there,

Thanks for sharing this API, very useful.
It shows as South Korea and then one more time as South, Korea. Both have the same data on confirmed, recovered, deaths.

You rock, appreciate it!
Alex G.

I have created front-end in vuejs using your API

I have created a front-end website using your API, it can be accessed from this link: https://corona-tracker-2020.netlify.com/ and source code of that project is available here: https://github.com/akashrajum7/corona-tracker.

Thank you.

We have created table based data but show late information then other

https://github.com/rvpatel/COVID-19-Statistics-Checker-table
https://www.worldometers.info/coronavirus/

Last 24 hours?

Is it possible to get just the new confirmed cases in the last 24 hours in each country?

It will help in tracking which country is successfully flattening the spread of the virus and controlling it.

Global summary daily

Hi, Would it be possible to add a global summary to the daily single date endpoint as well? Thanks.

Country

Is there a way from the API that lets us get Data about one Country?
I want to deploy the API but let it just show Data about my Country atm!

Open Source Helps!

Thanks for your work to help the people in need! Your site has been added! I currently maintain the Open-Source-COVID-19 page, which collects all open source projects related to COVID-19, including maps, data, news, api, analysis, medical and supply information, etc. Please share to anyone who might need the information in the list, or will possibly contribute to some of those projects. You are also welcome to recommend more projects.

http://open-source-covid-19.weileizeng.com/

Cheers!

Angular application

Hello, i built an angular application using your api if you want to share :)
You can visit here : https://souryvath.github.io/ng-covid-19/
The repository : https://github.com/souryvath/ng-covid-19

Thank you for your awesome work :)

USA data not working

https://covid19.mathdro.id/api/countries/USA
errors with
502: BAD_GATEWAY
Code: NO_STATUS_CODE_FROM_FUNCTION

How to get daily report on spesific country?

Python/Flask App Using COVID-19-API

virustracker

Python Flask application that displays virus information in a customizable format

Description

Web application written in Python using Flask which provides a single root page to display current World and customizable country COVID-19 information. This application reads from a configuration file which can be used to customize the following:

• Support email address for your page
• Page logo (set to World Health Organization's logo by default)
• API root (set to Muhammad Mustadi's COVID-19 JSON API by default)
• Countries, can be used to set the countries you would like to see information on

https://github.com/DykemaBill

Mainland UK missing from GBR country numbers

/api/daily/3-23-2020 empty

It appears yesterday's /daily/ endpoint is completely empty for whatever reason. Previous /daily/ endpoints are currently working fine, but there seems to be no data for 3-23-2020.

Corona Tracker Angular SPA using Covid-19-API

Corona tracker written in Angular, shows graphs and other information about COVID-19 spreading around the world.

Website: Corona Tracker
GitHub Repo: CoronaTracker

Work needed

I'm a backend Node.js developer and I would like to contribute. Is there any work I can do that wouldn't overlap with what is already being done?

Per country daily summary

How to get per country daily summary??

Changes to the API broke lastUpdate for /api/confirmed

It is working as expected at this commit. 95e6e5d

[
{
"provinceState": "Hubei",
"countryRegion": "China",
"lastUpdate": null,
"lat": 30.9756,
"long": 112.2707,
"confirmed": 67800,
"deaths": 3153,
"recovered": 59882,
"active": 4765,
"fips": null,
"incidentRate": null,
"peopleTested": null,
"iso2": "CN",
"iso3": "CHN"
},