Using Programs

All widgets are created as part of a ProgramProgram - A time-ordered sequence of widgets. A program can have extra information attached, like scheduling data and video preview URL for aiding in producing the program in the Producer Site. A widget can only be published to a single program, and only subscribers to a given program will see its widgets.. A widget that was published to one program cannot be published to another one.


One program per video in your app

It is generally a good idea to have a program for each video in your app. That way it is easier for producers to stay organized with what is live now and what is coming up next, and it is also easier to go back in the history and review analytics and metrics for a specific video.

Get Widgets for Program

Once a widget has been created in a program it is available in the API. Each program has a widgets_url hyperlink field that can be requested to get all the widgets created in that program. The program widgets resource is paginated.

import requests

# Fetch program resource
r = requests.get('')
program = r.json()

# Fetch program's widget history using the widgets_url
r = requests.get(program['widgets_url'])
history = r.json()