Getting Started – Paid

Getting started is fast and easy! This page walks you through getting set up, getting the data and getting the video.

Step 1: Get Your Credentials

Your welcome letter contains your Customer ID, Developer ID, Security Token, and Media Manager account information. If you have not yet received your credentials, please contact sales.

Note: Please keep this information in a safe place as you will need it to access content at IVA.

Step 2: Get The Data

Each video asset in IVA’s database is identified by a unique Published ID that you will need in order to request a video from us. The IVA OData API 2.0 is our newest data API and it offers robust queries for getting to our Published IDs. Another popular method is to use our Pinpoint API which uses an ID from another data provider (one we match to) to find the IVA Published ID. (See the Special Methods section in the data dictionary for more on how to do this).

Example: AMG ID v 475797 Web Service Call:{your-id}

» In the example, the web service returns Published ID 244133.

Remember: Replace {your-id} above with your information and get back the Published ID of the entertainment program you want.

Read our OData Web Services for other ways to find the data you need.

Each video asset in our library is available in multiple formats designed to meet the wide variety of screens and operating systems used by consumers to watch content. Not every encode is available for every title; for example HD was not around for older films.

Insert the Published ID for the title you want (244133 in the example below) plus your Developer ID into the URL shown below and Web Services will return back the XML with all of the available encodes. You will need this information if you plan on using your own player and creating links to the trailers instead of using our custom player. Here is the URL:$filter=PublishedId%20eq%20244133&developerid={your-id}

The table below lists the properties that are returned in the XML from the query. Use any of these properties to make your query more specific. Example: if you just want to know if a title is available in HD (Rate = 2500).

Encodes Entity (OData 1.0/2.0)

A collection of Encodes available from IVA to use with the Video API or IVA’s HTML5 or Flash Video Players.
PublishedIdUnique ID for the VideoAsset.
StreamingFlavorIdID for the type of encode.
DateDigitizedThe date in which the video was last encoded.
rateThe Kbps target for the encode. Ex: 450 = 450 Kbps of the combined audio and video tracks bitrate.
FileTypeThe video format of the encode. Ex: MP4
URLContains either a URL for the asset without a customerID or "see video api documentation"
RemoteURLTrue or False. Determines if the content is redirecting to another server for delivery. The overwhelming majority of encodes are ‘false’, meaning they are not being served from a 3rd party. Note: Content not served from IVA is free of charge and not included in the GB billing reports.
ProprietaryCustomerIdUsed only for Subscribers who use IVA to encode their own content. The default value is -1 meaning not proprietary.
IDUnique ID for the encode.

For more information on the IVA OData API click here.

Step 3: Get The Video

Before you can get the video you will need to choose how you will play the video (our custom player or your own player).

Using IVA’s Custom Player

Login to Media Manager and create a player to use. Pick any video inside Media Manager and click generate code. Copy that code and replace the Published ID to play any video in our library.

<script src="" type="text/javascript></script>

<div id="ivadiv"></div>

<script type="text/javascript">// <![CDATA[
ivaplayer('ivadiv').setup({ 'flashplayer': ';playerid=247&amp;sub=SupportSite', 'customerid': '69249', 'publishedid': '244133', 'playerid': '247', 'playlistid': '0', 'videokbrate': '2500', 'fmt': '4', 'width': '640', 'height': '360', 'sub': 'SupportSite'});
// ]]></script>

Using Your Own Player

You will need to create a link to the content. To do this you will need the data you got back in step 1 and information from your welcome letter you received from your salesman when you subscribed. To make a link you will need:

  • Published ID
  • Customer ID
  • Secret Token
  • Base URL from Encodes Entity
  • Rate from Encodes Entity

Once you have all this information see the documentation on Making Trailer Links. When you are done you will have a link that looks like this: