COVID-19 GraphQL API

API Endpoint: covid19-graphql.herokuapp.com

This GraphQL API provides real-time, updated information on the COVID-19 cases across the world caused by the Coronavirus SARS-CoV-2.

Data is sourced from the Github repository and the OPS dashboard from Johns Hopkins university.

Features

• Provides current, up-to-date statistics per country, subregion and region.

• Provides timelines per country, subregion and region

• Lightning fast due to smart caching and aggregation

• Easy to run locally:

  npx covid19-graphql
  

Example GraphQL queries

Following are some example GraphQL queries:

Latest statistics

1{
2  latest {
3    confirmed
4    deceased
5    recovered
6    lastUpdated
7  }
8}

Execute this query »

Global timeline since March 2020, excluding China

1{
2  timeline(excludeCountries: "CN", from: "2020-03-01") {
3    date
4    confirmed
5  }
6}

Execute this query »

Latest statistics for each country in Southern Europe:

1{
2  subRegion(name: "Southern Europe") {
3    countries(count: 20) {
4      count
5      totalCount
6      hasNext
7      results {
8        name
9        latest {
10          lastUpdated
11          deceased
12        }
13      }
14    }
15  }
16}

Execute this query »

List all countries with confirmed cases, by region and subregion

1{
2  regions {
3    name
4    subRegions {
5      name
6      countries(count: 100, filter: { hasCases: true }) {
7        results {
8          name
9        }
10      }
11    }
12  }
13}

Execute this query »

Running it yourself

In order to be in control of your own API endpoint instead of relying on someone else's, you can spin up a COVID19 GraphQL server locally with npx:

npx covid19-graphql

Or install it globally:

npm install -g covid19-graphql

Then you can start the GraphQL server by entering:

covid19-graphql

Environment variables

The following environment variables affect the configuration of the server:

• NODE_ENV: When set to production, will disable tracing, playground and various other debugging settings. It will enable various performance optimizations.
• PORT: Determines the HTTP port on which the server will run (defaults to port 12000)
• ENABLE_TRACING: Overrides the default GraphQL tracing setting (on for development, off for production). Use 1 to turn on 0 to turn off.
• ENABLE_PLAYGROUND: Overrides the default GraphQL playground flag (on for development, off for production). Use 1 to turn on 0 to turn off.

Example:

PORT=8080 covid19-graphql

Development

After cloning this repo, enter npm install to install the dependencies (btw Node >= 10 is required).

The following commands are most useful:

• npm run dev: Starts a development server
• npm run build: Creates a build
• npm start: Starts the server