Skip to main content

An API around the https://github.com/CSSEGISandData/COVID-19 dataset

Project description

COVID-19 API

coronavirus-api.net

This API is a wrapper around Johns Hopkins' https://github.com/CSSEGISandData/COVID-19 dataset.

Please abide by their terms of use with respect to how you use their data via this API.

Installation

This package is hosted on pypi

The recommended method of installation is through pipx.

pipx install covid-19

However, covid-19 can also be pip-installed as normal.

pip install covid-19

Website

The coronavirus api website allows several methods of slicing and dicing the data.

For example, the get_all endpoint (which returns all data) can be filtered for rows which only contain data for California and Colorado as of March 22nd in this way:

https://coronavirus-api.net/get_all?min_date=2020-03-22&states=["California", "Colorada"]

The main page will list the available endpoints and their available parameters.

CLI Usage

This package installs a command-line tool, covid

It lets you programmatically access John Hopkins' dataset via terminal commands or via a rest api that can itself be instantiated locally from the cli

covid --help

This API is a wrapper around Johns Hopkins' https://github.com/CSSEGISandData/COVID-19 dataset.

Please abide by their terms of use with respect to how you use their data via this API.


Available Commands:

 - get_all: Fetch all data from John Hopkins.
 - countries: Return all countries and regions in the dataset.
 - states: Return all states and provinces in the dataset.
 - for_date: Return all data for a specific date.
 - serve: Serve REST API locally.

i.e.

covid for_date 2020-03-21
[
    {
        "Province/State": "Hubei",
        "Country/Region": "China",
        "Last Update": "2020-03-22T09:43:06",
        "Confirmed": 67800.0,
        "Deaths": 3144.0,
        "Recovered": 59433.0,
        "Latitude": 30.9756,
        "Longitude": 112.2707
...

Docker

This package can also be run as a docker image.

docker run knowsuchagency/covid-19 --help

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for covid-19, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size covid_19-0.4.0-py3-none-any.whl (5.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size covid-19-0.4.0.tar.gz (4.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page