Neoteric Plumbing Mishap


    0.3.1 • Public • Published


    Node-RED node for The Weather Company (TWC) COVID-19 Disease Tracking API

    These nodes implements the TWC APIs for COVID-19 Disease Tracking.

    The API allows you to track the progression of a disease for a given location. It provides information regarding active diseases including confirmed cases, deaths, and recoveries over a period of up to 60 days in the past.

    Node-RED COVID-19 Dashboard


    Either use the Editor - Menu - Manage Palette - Install option, or run the following command in your Node-RED user directory (typically ~/.node-red).

    $ npm install node-red-contrib-twc-covid19-tracker


    To use The Weather Company API for COVID-19 Disease Tracking, you need an API key. Call for Code participants can register to join the Call for Code 2020 COVID Challenge and request a TWC API key for this Node-RED node at A time-limited API key will be sent to you via email.

    node-red-contrib-twc-covid19-tracker Nodes

    This Node-RED package creates twc covid19 tracker and twc covid19 country report nodes in your Node-RED palette.

    • twc covid19 tracker - Query 60 day history of COVID-19 statistics at the Country, State, County level by Geocode, Place ID or Postal Code.
    • twc covid19 country report - Query the current state of a disease for a set of countries globally.

    Review the CHANGELOG for enhancement history.

    Explore the node-red-contrib-twc-covid19-tracker Node-RED node

    Once the node is installed in your Node-RED palette, drag it to your flow and double-click on the twc covid tracker node. In the Properties dialog box enter the following information:

    • Your TWC API Key provided by
    • Specify whether the node will retrieve country, state or county COVID-19 data
    • Specify the location you are interested in; geocode latitude/longitude, Place ID, or Postal Key
    • The location either via latitude/longitude, place id or postal code. Examples:
      • 40.74,-73.99
      • 327145917e06d09373dd2760425a88622a62d248fd97550eb4883737d8d1173b
      • 10001:US

    Review the node information documentation in the Node-RED right hand side bar for techniques that allow you to programmatically pass in the above parameters via a msg.twcparams json object.

    node-red-contrib-twc-covid19-tracker node properties

    Review the TWC Disease Tracker API documentation

    The Weather Company offers TWC Weather Data Packages that are available for purchase. The Node-RED node in this package implements the Disease Tracking API service and is free for Call for Code participants (please review the Terms of Service)

    The TWC Disease Tracker API allows you to track the progression of the COVID-19 disease for a given location. It provides information regarding active diseases including confirmed cases, deaths, and recoveries over a period of up to 60 days in the past.

    See the online documentation for more information about The Weather Company API for Disease Tracking.

    See the online documentation for more information about The Weather Company API for Global Disease Country Reporting.

    The APIs returns an array of json objects containing COVID-19 data which you can integrate into dashboards or applications.


    For a full tutorial with instructions, screenshots and examples, review the IBM Developer Build a Node-RED COVID-19 dashboard tutorial.


    Learn how to implement a Node-RED COVID-19 statistics dashboard using The Weather Company Disease Tracker API.

    Access COVID-19 location and infection data through an API provided by The Weather Company (TWC) and incorporate that data in Node-RED dashboard, charts, and tables. Use Node-RED for data analysis and data visualization of COVID-19 infections by country, state and county.

    Four examples are provided in the examples folder.

    Example #1

    COVID API Test Example

    Example #2

    COVID-19 Dashboard Node-RED COVID-19 Dashboard

    Example #3

    COVID-19 Dashboard COVID-19 Dashboard

    Example #4

    COVID-19 Dashboard COVID-19 Dashboard

    This flow has four sections:

    1. The Load State Table section displays a Node-RED Dashboard button widget, a Template node which contains a CSV list of States and zip codes, and a CSV node which splits the state list into individual messages.
    2. The Query COVID Stats for all 50 States section calls the TWC Disease Tracking API to retrieve the COVID19 infection data for each state. It builds an array of states and their COVID19 stats.
    3. The Build Charts and Tables section displays a table of states with sortable COVID19 stats. When a user selects a state, the 60 days of COVID-19 historical data is displayed on a chart and table. It also plots a chart of new cases reported each day and a seven day moving average that demonstrates flattening the curve or states that have recurrent outbreaks.
    4. The COVID Map of USA section determines the latitude/longitude of the state by using a TWC Location Search API call. It then drops pins with state COVID19 metrics on a map.



    • The data for this API is aggregated from trusted sources listed in the response of each API call.

    Enjoy! Give me feedback if you have suggestions on how to improve this node.


    This npm package is licensed under the Apache Software License, Version 2. Separate third party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 (DCO) and the Apache Software License, Version 2.

    Apache Software License (ASL) FAQ


    npm i node-red-contrib-twc-covid19-tracker

    DownloadsWeekly Downloads






    Unpacked Size

    943 kB

    Total Files


    Last publish


    • johnwalicki