Welcome to IVA! Gracenote and IVA have partnered to make integrating video into your site as easy as 1, 2, 3, 4. This page will walk you through making a link to a video.
Step 1: Get your credentials
Your customer service representative at Gracenote should provide you with the following when you sign up:
- Customer ID ( this is your comany’s account number)
- Security Token ( do not share this with anyone outside your organization)
- Developer ID (used to access the Data from IVA’s Web Service)
Note: Please keep this information in a safe place as you will need it to access content at IVA.
Step 2: Get the data
Gracenote provides their customers with IVA’s database of Published IDs. Select the Published ID for the title you want video for. This ID is only the Main Entertainment Program ID. For a full map of Gracenote ID’s to all of the related Entertainment Programs including different language versions and alternate content, please contact IVA’s Support Team for FTP credentials to the mapping table.
Note: Gracenote refers to IVA’s Published ID’s as “IVA Pinpoint ID”. Any documentation on their site will refer to it as that and any documentation on this site will refer to it as the PublishedID.
Step 3: Get available encodes
Each title in our database is encoded 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; HD was not around for older films, for example.
Insert the Published ID for the title you want (244133 in the example below) plus your Developer ID into the URL shown below and IVA OData API will return back the XML with all of the available encodes. Decide the FileType and Rate you want. Get the URL property for that FileType and Rate. You will need this to make a working link in Step 4. Here is the URL:
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.
|PublishedId||Unique ID for the VideoAsset.|
|StreamingFlavorId||ID for the type of encode.|
|DateDigitized||The date in which the video was last encoded.|
|rate||The Kbps target for the encode. Ex: 450 = 450 Kbps of the combined audio and video tracks bitrate.|
|FileType||The video format of the encode. Ex: MP4|
|URL||Contains either a URL for the asset without a customerID or "see video api documentation"|
|RemoteURL||True 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.|
|ProprietaryCustomerId||Used only for Subscribers who use IVA to encode their own content. The default value is -1 meaning not proprietary.|
|ID||Unique ID for the encode.|
Step 4: Make a link to the video
To make a link to a video you need your Customer ID, your Security Token, and the base URL you got from the Encodes Entity above.
- Take the base URL (Encodes Entity)
- Add your Customer ID
- Add a time to live (e)
- Take all 3 (base + CustomerID + time to live), run an MD5 hash using your Security Token and append to URL (h)
When finished your URL should look like this:
For more information, including a full description of all the parameters and creating the hash code please see this page: Video-API
We look forward to working with you! Should you have any questions please feel free to email our Support Team.
Thanks for choosing Gracenote and IVA!