Getting Started with IVA's Free Trailer API
Getting started using IVA's Free Trailer API is super fast and super easy. Best of all it is free! This document takes you through the steps needed to get the data for the video asset, and then shows you the embed code to put on your site to play that video.
Please note that our Free Trailer API Player is for Web only. Not for use in mobile applications.
Step 1: Get a Developer ID
If you have not done so already please sign up for a free developer account. You can find the sign up form on the main support page. This will allow you to access all of IVA's meta data and information about the trailers.
Note: Non-subscribers are limited to 500 data calls per hour. This does NOT affect how many videos you can play.
Step 2: Get the Data
OData Web Services is our newest data API. Read the documentation and review the examples to learn how to find the information you need to support the video assets you want. Every video asset in our database has a unique Published ID that you will need to pass into the embed code to play the video.
| For example: I want a list of movies with DVD/Blue-ray release dates after a certain date. Web Service Call: http://api.internetvideoarchive.com/1.0/DataService/ReleaseEvents()?$filter=((cast(ReleaseTypeId,'Edm.Int32')) eq 2) and (ReleaseDate gt datetime'2011-10-18T00:00:00')&developerid={yourid} Take any Published ID from this list. For our example we will use Published ID = 79937 for Harry Potter and the Deathly Hallows - Part 2. |
Step 3: Embed the Video
Read the documentation on the Free Trailer API. This will take you through embedding the video on your site. Below is an example of an embed code that you can use on your website or blog using the Published ID that we described in step 2. Replace the Published ID in the code below to play any video in our library. For more information on controling the player and skin options please refer to the Free Trailer API documentation.
| Example: "<embed src="http://www.videodetective.net/flash/players/movieapi/?publishedid=79937" flashvars="skin=kleur&autostart=false" bgcolor="#000000" width="400" height="280" allowfullscreen="true" allowscriptaccess="always" /> <br /> Trailer provided by <a href="http://www.videodetective.com/">Video Detective</a>" |