Welcome Gracenote Customers! 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)
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. Please 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.
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
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.)
| Property || Description |
Unique ID for the VideoAsset. |
ID for the type of encode. |
The date in which the video was last encoded.
The Kbps target for the encode. Ex: 450 = 450 Kbps of the combined audio and video
The video format of the encode. Ex: MP4 |
This will contain the base URL for the video. You will use this along with
other parameters to create a link to the content. (customers only)
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.
Used only for Subscribers who use IVA to encode their own content. The default
value is -1 meaning not proprietary.
Unique ID for the encode.
For more information on the IVA OData API see: http://www.internetvideoarchive.com/IVA/Support/documentation/data/iva-odata-api
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: http://www.internetvideoarchive.com/IVA/Support/documentation/video/Video-API
We look forward to working with you! Should you have any questions please
feel free to check out our forums or email our Support Team. Thanks for choosing
Gracenote and IVA!
| IVA Support Team |
The World's Largest Distributor of Online Trailers!