/API

API for Current cases and more stuff about COVID-19 or the Novel Coronavirus Strain

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

All Contributors

Join our Server!

Discord server

API

API for Current cases and more stuff about COVID-19 or the Novel Coronavirus Strain https://corona.lmao.ninja/

Endpoints

GET Request Output
https://corona.lmao.ninja/all Returns all total cases, recovery, and deaths.
https://corona.lmao.ninja/countries Returns data of all countries that has COVID-19
https://corona.lmao.ninja/countries?sort={parameter} Returns data of each country sorted by the parameter
https://corona.lmao.ninja/countries/{country-name} Returns data of a specific country. If an exact name match is desired pass ?strict=true in the query string
https://corona.lmao.ninja/states Returns all United States of America and their Corona data
https://corona.lmao.ninja/jhucsse Return data from the Johns Hopkins CSSE Data Repository (Provinces and such)
https://corona.lmao.ninja/historical Get historical data from the start of 2020. (JHU CSSE GISand Data)
https://corona.lmao.ninja/historical/{country-name} Get historical data from the start of 2020 for a specific country. (JHU CSSE GISand Data)

Loading and using our NPM Package

We suggest you load the module via require, pending the stabalizing of es modules in node:

const covid = require('novelcovid');

Documentation

To actually use the data, you will need an async/await.

// Declare the package
const covid = require('novelcovid');

// Now we create a async/await
(async () => {

    // Now we await it.
    let all = await covid.getAll();

    // Make sure you return it, this usually implies if you are using this inside a function.
    // Use \n to break lines.
    return console.log(`Cases: ${all.cases}\nDeaths: ${all.deaths}\nRecovered: ${all.recovered}`)
})()

Sorting the data.

Some methods can be sorted.

const covid = require('novelcovid');

(async () => {
    let sortedCountries = await covid.getCountry({sort: 'recovered'});
    return console.log(sortedCountries);

    let sortedStates = await covid.getState({sort: 'deaths'});
    return console.log(sortedStates);
})();

Filtering for a specific country/state.

const covid = require('novelcovid');

(async () => {
   // Specific Country
   let specificCountry = await covid.getCountry({country: 'United States'});
   return console.log(specificCountry);
   
   // Specific State
   let specificState = await covid.getState({state: 'New York'});
   return console.log(specificCountry);
})();

Note Since data.updated returns milliseconds, you can do new Date(data.updated) as it returns an ISO Date

You can read more about new Date() here

For further support, you can join our discord server! More Tutorials can be found there too! https://discord.gg/EvbMshU

Sources:

https://www.worldometers.info/coronavirus/ https://github.com/CSSEGISandData/COVID-19/tree/master/csse_covid_19_data/csse_covid_19_time_series

Contributors ✨

Thanks goes to these wonderful people (emoji key):


EliteDaMyth

💻

Ethan Winters

🐛

dicedtomato

💻

apollyon600

📖

James Shelley

👀

Ryan Harlow

🐛

Ali Tas

🐛

Walter Corrales

💻

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