Working with Data Inputs
Updated over a week ago

Data inputs allow you to connect external data to Viz Flowics, so you can create data-driven graphics. When you create a data input, Viz Flowics generates an endpoint where you can push or stream your data.

To create a data input, on the top bar click DATA CONNECTORS, select Data Inputs, then click the plus sign and select the data input to create.

Be aware

Adding new data inputs is restricted to company administrators. Please contact your company admin to add the new input for you. Alternatively, you can reach out to our support team at to request access level.

There are two types of data inputs: generic and custom.

Generic Data Inputs

This type of data input is useful when integrating your data, either through the Data Bridge or your own system that enables data transfer to a Viz Flowics input.

The are two types of generic data inputs:

  • JSON HTTP Push - Content: Use this data input when your data source is a JSON file (file:///), or a REST API (HTTP, HTTPS) that exposes the content in JSON format.

  • JSON Streaming Push - Content: Use this data input when your data source is a local WebSocket (wss://).

When setting up a generic data input, you will need to generate a data schema. This is a JSON object that defines the structure of your data and helps Viz Flowics map the data to your graphics. To do so paste your JSON data into the example data box and then click on the 'Generate schema from example' button.

If you have already generated the schema, click on 'Direct Input' and paste it there

Custom Data Inputs

Viz Flowics provides custom data inputs for specific third-party data providers. E.g., if you are using ScoreboardOCR as your data provider, Viz Flowics has custom Data Input designed for this purpose, along with a corresponding native data connector.

Custom data inputs are typically easier to set up than generic data inputs, as you don't need to generate the schema in most of them.

Here is a list of the available custom data inputs:

Data Input


ASI API - Computed data by activity sink

Connect this data input with Insiders ASI API data connector

Apex Legends Global Series - Standings

Connect this data input with Apex Legends Global Series data connector

Basketball REST v1 - Livestream - Basketball

Connect this data input with Genius Sports data connector

Equipe Timekeeping Client API - Clock

Connect this data input with Equipe data connector

PUBG Mobile on-premise - API Sink

Connect this data input with PUBG Mobile on-premise data connector

Scoreboard WebSocket Integration - Timing & Scores

Connect this data input with Scoreboard OCR data connector

Time2Win API - Race Clock

Connect this data input with Time2Win data connector

Wiclax race scoring & timing - HTTP Export

Connect this data input with Génialp Wiclax race scoring & timing data connector

Control access settings

When setting up a Data Input (generic or custom), you will find additional settings that are optional but meant for control access purposes:

  1. Control Access - Allowed CORS Origin: This allows data to be pushed from the browser directly to Flowics from other webapps. Can be tested with an OPTIONS request: curl -i -X OPTIONS -Horigin:http://xx -HAccess-Control-Request-Method:POST… for more info about the OPTIONS method click here

  2. Control Access - Allowed IP Networks: Allows to receive only data from certain hosts on the internet. The list can contain individual IP addresses (IPv4/IPV6) or networks

Understanding Data Flow

Once you have created a data input, you can start pushing data to it. Use an external system that pushes data (via HTTP POST or WebSockets, whether using a JSON Push or JSON Streaming Push data input) to the Viz Flowics input.

This system can be your own app or script, or it can be the Data Bridge that lifts a local JSON and pushes it or connects to a local Rest API.

Data can flow to Viz Flowics in two ways:

  • Local to the cloud: Data is transferred from a local source to Viz Flowics through the Data Bridge or your own custom app/script that pushes the data to a Flowics data input.

  • Cloud to cloud: Data is transferred from a third-party data provider in the cloud to a Viz Flowics data input.

Using Data Inputs

To use data inputs in your graphics packages, you will need to create a data connector. A data connector maps the data from the data input to the specific elements in your graphics.

For example, if you have a data input that contains information about sports scores, you could create a data connector to map the data from that input to the score text element in your sports graphics.

Did this answer your question?