COVID-19

The COVID-19 modules enable you to monitor COVID-19 statistics (including historical data) globally, or for each country.

61d6c5e799c02.svg

For more information on data, please refer to the Data Sources section in this article.

Notice

Free operations.

You will not be charged for operations used by any of the modules in the COVID-19 app.

Stats

List Global Historical Numbers

This module allows you to retrieve historical data for the world.

Limit

Enter how many days in the past you want to start the return of data. The result will return data from this day forward.

The following statistics are available in the module's output:

Number of Confirmed

The total number of confirmed cases of COVID-19 in the given area.

Number of New Confirmed

The absolute number of new cases in the day, defined as: Number of Confirmed today - Number of Confirmed yesterday.

Growth Factor of Confirmed

A growth factor is defined as: Number of Confirmed today / Number of Confirmed yesterday.

Growth Rate of Confirmed

A growth rate is defined as: Growth Factor of Confirmed - 1.

Number of Deaths

The total number of deaths caused by COVID-19 in the given area.

Number of New Deaths

The absolute number of new deaths in the day, is defined as: Number of Deaths today - Number of Deaths yesterday.

Growth Factor of Deaths

A growth factor is defined as: Number of Deaths today / Number of Deaths yesterday.

Growth Rate of Deaths

A growth rate is defined as: Growth Factor of Deaths - 1.

Number of Recovered

The total number of people who have recovered successfully in the given area.

Number of New Recovered

The absolute number of newly recovered in the day, defined as: Number of Recovered today - Number of Recovered yesterday.

Growth Factor of Recovered

A growth factor is defined as: Number of Recovered today / Number of Recovered yesterday.

Growth Rate of Recovered

A growth rate is defined as: Growth Factor of Recovered - 1.

Number of Active

The total number of active cases in the specified area (can also be computed as Confirmed - Deaths - Recovered)

Number of New Active

The absolute number of new active cases in the day, defined as: Number of Active today - Number of Active yesterday.

Growth Factor of Active

A growth factor is defined as: Number of Active today / Number of Active yesterday.

Growth Rate of Active

A growth rate is defined as: Growth Factor of Active - 1.

List Historical Numbers for a Country

This module allows you to retrieve historical data for a specified Country, a Province in a Country, or a County in a Province of a Country, if available.

Country

Specify the country you want to retrieve the data for.

Select the country from the drop-down menu or switch to the mapping mode (using the map button ) and provide the country name (e.g. United States) or ISO 3166-1 alpha codes (e.g. us or usa).

Province

Select (or map) the province to filter results by (if available).

County

Select (or map) the county to filter results by (if available).

Limit

Specify how many days to the past should the module retrieve.

Note

The output of the module offers the same datapoints as the output of the Get Current Numbers for a Country, but in this case, the module returns several bundles instead of one. One bundle equals one day.

Get Global Current Number

Retrieves the latest global statistics for COVID-19 in the world.

The module doesn't need to be set up.

Statistics available in the module's output.

Get Current Numbers for a Country

This module allows you to get current numbers of the COVID-19 virus for a given Country.

If there are Provincial data available for the Country, you can get the data just for the given Province.

If there are County-level data available for the Province, you can retrieve even more concrete data.

Country

Specify the country you want to retrieve the data for.

Select the country from the drop-down menu or switch to the mapping mode (using the map button) and provide the country name (e.g. United States) or ISO 3166-1 alpha codes (e.g. us or usa).

Province

Select (or map) the province to filter results by (if available).

County

Select (or map) the county to filter results by (if available).

Statistics available in the module's output.

Data sources

We're using data available from the public GitHub Repository of Johns Hopkins Whiting School of Engineering.

We're downloading those data, converting and serializing them to a unified format that we've designed, processing them and storing them in our own database, and assorting them by Countries, Provinces, and Counties.

The level of granularity of the data differs from one country to another, for some smaller countries there aren't counties or even provinces available.

While other services and public APIs act just as a "middle man" between the user and the datasource, we're also adding a lot of additional information. Right now, we're able to compute growth factors, rates and also absolute numbers of new cases for each day, and we're planning to add even more stats from a variety of datasources, and then provide this aggregated data to our users. The Core of the API checks the datasources at regular intervals and refreshes our database periodically.

Note

We're still working on adding new functionalities, new aggregation, new datasources, and so on.