VSTUB Assembly API Endpoints

Generate VSTUB from a Discovered Asset or set of Assets

GET/assembly/vstub?id=x&o=y&d=z - Click here for this endpoint's full API specs and testing tool (LVS login required)

OR

POST/assembly/vstub - Click here for this endpoint's full API specs and testing tool (LVS login required)

Purpose

You can assemble VSTUB media from multiple assets using asset Ids and offset & duration values using either via GET or POST endpoints. You may also indicate optional rules for scaling your assembled media, for situations where your source assets vary in aspect ratio and dimension.

Examples

GET https://api.lvs.linius.com/v3/assembly/vstub?id=126,124&o=2,2&d=23,25

or

POST https://api.lvs.linius.com/v3/assembly/vstub

with the following request body:

{
"height": 0,
"items": [
{
"assetId": 126,
"duration": 23,
"offset": 2,
},
{
"assetId": 124,
"duration": 25,
"offset": 2,
}
],
"scaleMode": "FIT"
}

Generate VSTUB from multiple Playlist Elements

GET /assembly/vstub/elements?id=x - Click here for this endpoint's full API specs and testing tool (LVS login required)

Purpose

Use this endpoint in situations where you need to assemble media from multiple Playlist Elements (i.e. the building blocks of Playlists) without having to define or refer to a specific playlist.

Generate VSTUB for a single Asset, Playlist, or Playlist Element

GET /assembly/vstub/{id} - https://lvs.linius.com/board/spec/v3/assembly/assembleAny_3

Purpose

Use this endpoint in situations where you want to play a single playable object (Asset, Playlist, or Playlist Element) in its entirety (e.g. when you want to trigger playback via a "Watch full video" button for an item in a list of videos).

Generate VSTUB from Asset with Interstitial Content

GET /v3/assembly/vstub/{assetId}/insert - Click here for this endpoint's full API specs and testing tool (LVS login required) 

Purpose

Use this endpoint in scenarios where you want to present short interstitial content (e.g. ads) at specific moments within your feature content (e.g. a movie, TV show, or sporting event.