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 use to play a trailer.
Step 1: Get a Developer ID
If you have not done so already please sign up for a free developer account. 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
IVA's OData API 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. URL: 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 the player and options please refer to the Free Trailer API documentation.
| Example: "<iframe width='400' height='300' src='http://www.videodetective.com/embed/video/?publishedid=79937&options=false&autostart=false&playlist=none&width=400&height=300' frameborder='0' scrolling='no'></iframe>" |