Quick Start Guide (subscription)

Quick Start Guide (free)
Our two quick start guides show you step-by-step how to get the data and how to put a trailer on your site. 

Sign up for a developer ID. It's Free!

( * Subscription Required)


Shopping API

IVA's Shopping API connects your visitors to all the major related services (Amazon, Netflix, iTunes, Fandango).  Check out the documentation below.


The Shopping API provides a simple and fast integration to external sites that provide products, downloads, and/or additional information about a movie, game, or music video. The Shopping API can be used to access movie show times, purchase tickets, download content, rent or purchase DVDs or videogames.

 To see an example of the Shopping API in use, go to VideoDetective and select a trailer to wactch.  On the page, below the player will display available shopping options if there are any.

URL:                       http://api.internetvideoarchive.com/Common/Shopping.aspx
Description:        The Shopping API provides access to shopping data for movies, games, and music videos.
Protocol:               XML
Default Order:      NA
Updated:               Daily

Special Parameters:

ID Types (String) - the ID Types parameter specifies the shopping site and optional affiliate ID for a given title. To enable multiple sites, concatenate multiple IDs/affiliate IDs together separated by a comma.  To get a URL to Amazon for product purchases using your Amazon Affiliate ID, your ID Types parameter would look like: idtype=13:amazon_affiliate_id.  

This tells the API to only include results for Amazon and to include the affiliate ID in the URL so your account is credited with the sale.  See example URL below for multiple shopping sites.

Amazon 13 - Amazon
 Google 16 - Google Movie Showtimes (no affiliate ID)
iTunes
17 - iTunes (use your Web Services Token)
Fandango
18 - Fandango.com
Netflix
39 - Netflix
Hulu
42 - Hulu (not Hulu+)
 Barnes & Noble logo  49 - Barnes & Noble
Vudu logo   40 - Vudu
 Crackle  60 - Crackle
Walmart Logo   61 - Walmart


Search Term - This is the Published ID of the title for which you see information.
Developer ID - The ID assigned to you when you signed up for the API.

 

Example Usage:

 


Additional Functionality:

You can also search iTunes availability by country via our Shopping API by passing along the specific country code you wish to look up.   By default the shopping API will return results for the US.  If the item being searched for is not available in the country store specified, no results will be returned.

In the following examples please note that iTunes is  idType = 17 and the searchterm = xxxxxx is IVA’s Published ID of a title.  Also the Country Code is a two character Alphabet code.  You can find the list of country codes here:  http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2


Example – Request to Great Britain iTunes Store

http://api.internetvideoarchive.com/Common/Shopping.aspx?idtypes=17:AffiliateId:GB&searchterm=196293&developerid={ID}


Example – Request to Canadian iTunes Store

http://api.internetvideoarchive.com/Common/Shopping.aspx?idtypes=13:,16:,17:AffiliateId:CA,18:&searchterm=196293&developerid={ID