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)


Documentation Articles


All news

Using the Pinpoint API with our IVA OData API 1.0

Jason Schneid - Client Services Representative | Dec 19, 2011

The Pinpoint method is a great way to match to our data and get our Published ID's.  Check the list below to see if you have any of the ID's that we are already matched to.   Use those ID's with the Pinpoint Method to return the title information and the Published ID's.  Below is the ID matching table and an example of how to use the Pinpoint Method.  You will need to have a developer ID in order to use our API.

Rovi customers do not need to use pinpoint.  Click here for more information.

ID IdType
1 UMG UPC (DISCONTINUED)
2 UMG ISRC (DISCONTINUED)
4 BRIGHTCOVE SONYBMG (DISCONTINUED)
5 BRIGHTCOVE WMG (DISCONTINUED)
6 ROVI COSMO ID (MOVIES) [Depreciated use ID 62 instead]
7 AMG MOVIE
8 AMG MUSIC
9 CINEMA SOURCE (DISCONTINUED)
10 BRIGHTCOVE UMG (DISCONTINUED)
11 TMS
12 IMDB
13 AMAZON ASIN
14 MUZE MOVIE
15 UPC (API expects a 14 digit number)
16 GOOGLE MOVIE
17 ITUNES
18 FANDANGO
19 ISBN
20 EAN
21 NIELSEN FILM CODE (DISCONTINUED)
22 NIELSEN US RELEASE CODE (DISCONTINUED)
24 GAMEFLY (DISCONTINUED)
25 IGN (DISCONTINUED)
26 GAMESPY (DISCONTINUED)
27 GAMESPOT (DISCONTINUED)
28 UMG ISRC (DISCONTINUED)
29 SONY ISRC (DISCONTINUED)
30 WMG ISRC (DISCONTINUED)
31 WMG GUID
32 FLIXSTER
33 GRACENOTE
34 ROVI COSMO ID INTERNATIONAL (MOVIES) [Depreciated use ID 62 instead] 
35 ROVI COSMO ID (TV) [Depreciated use ID 62 instead] 
36 ROVI COSMO ID INTERNATIONAL (TV) [Depreciated use ID 62 instead] 
37 WB MPM
38 BASELINE
39 NETFLIX
40 VUDU
41 Muze_Games
42 HULU
43 LOVEFILM
44 EIDR
45 COMCAST VOD
46 FREEBASE
47 METACRITIC (DISCONTINUED)
48 MUZE UK_MOVIES
49 BARNES & NOBLE
50 GRACENOTE WORKTUI
51 GRACENOTE WORKTUITAG
52 GRACENOTE SERIESTUI
53 GRACENOTE SERIESTUITAG
54 GRACENOTE SEASONTUI
55 GRACENOTE SEASONTUITAG
56 MRQE (DISCONTINUED)
59 IVA_EIDR SUPPLEMENTAL
60 CRACKLE
61 WALMART
 62 ROVI COSMO / PROGRAM ID

Discontinued -  These are ID's that we have some matches for but currently do not maintain or keep up to date.

In the example below we are passing the ID 1756 for the movie "Jaws" and telling it to use ID Type 0 for the IVA Published ID.  Try it for your self with any of the corresponding ID Types above and an ID from that provider!

Pinpoint Method Example:

Call to API:  http://api.internetvideoarchive.com/1.0/DataService/GetEntertainmentProgramByPinpointId?ID='1756'&IdType=0&developerid={your-ID}

XML Returned: ' 
<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<feed xml:base="http://api.internetvideoarchive.com/1.0/DataService/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom"><title type="text">
GetEntertainmentProgramByPinpointId</title><id>http://api.internetvideoarchive.com/1.0/DataService/GetEntertainmentProgramByPinpointId</id>
<updated>2011-12-19T19:55:25Z</updated><link rel="self" title="GetEntertainmentProgramByPinpointId" href="GetEntertainmentProgramByPinpointId" />
<entry><id>http://api.internetvideoarchive.com/1.0/DataService/EntertainmentPrograms(1756)</id><title type="text">JAWS</title>
<published>2011-11-29T14:25:00Z</published><updated>2011-12-19T19:55:25Z</updated><author><name /></author><link rel="edit"
 title="EntertainmentProgram" href="EntertainmentPrograms(1756)" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/VideoAssets" 
type="application/atom+xml;type=feed" title="VideoAssets" href="EntertainmentPrograms(1756)/VideoAssets" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Language" type="application/atom+xml;type=entry" title="Language" 
href="EntertainmentPrograms(1756)/Language" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/SongCategory" 
type="application/atom+xml;type=entry" title="SongCategory" href="EntertainmentPrograms(1756)/SongCategory" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/SongRiaa" type="application/atom+xml;type=entry" title="SongRiaa" 
href="EntertainmentPrograms(1756)/SongRiaa" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/SongWarning" 
type="application/atom+xml;type=entry" title="SongWarning" href="EntertainmentPrograms(1756)/SongWarning" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/MovieMpaa" type="application/atom+xml;type=entry" title="MovieMpaa" 
href="EntertainmentPrograms(1756)/MovieMpaa" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/MovieCategory" 
type="application/atom+xml;type=entry" title="MovieCategory" href="EntertainmentPrograms(1756)/MovieCategory" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/TvCategory" type="application/atom+xml;type=entry" title="TvCategory" 
href="EntertainmentPrograms(1756)/TvCategory" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/TvRating" 
type="application/atom+xml;type=entry" title="TvRating" href="EntertainmentPrograms(1756)/TvRating" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Country" type="application/atom+xml;type=entry" 
title="Country" href="EntertainmentPrograms(1756)/Country" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ReleaseEvents" 
type="application/atom+xml;type=feed" title="ReleaseEvents" href="EntertainmentPrograms(1756)/ReleaseEvents" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/GameWarning" type="application/atom+xml;type=entry" title="GameWarning" 
href="EntertainmentPrograms(1756)/GameWarning" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/GameCategory" 
type="application/atom+xml;type=entry" title="GameCategory" href="EntertainmentPrograms(1756)/GameCategory" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Description" type="application/atom+xml;type=entry" title="Description" 
href="EntertainmentPrograms(1756)/Description" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProgramToPerformerMaps" 
type="application/atom+xml;type=feed" title="ProgramToPerformerMaps" href="EntertainmentPrograms(1756)/ProgramToPerformerMaps" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/VideoAssetScreenCapture" type="application/atom+xml;type=entry" 
title="VideoAssetScreenCapture" href="EntertainmentPrograms(1756)/VideoAssetScreenCapture" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/TitleAkas" type="application/atom+xml;type=feed" 
title="TitleAkas" href="EntertainmentPrograms(1756)/TitleAkas" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Copyrightholder"
 type="application/atom+xml;type=entry" title="Copyrightholder" href="EntertainmentPrograms(1756)/Copyrightholder" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Director" type="application/atom+xml;type=entry" 
title="Director" href="EntertainmentPrograms(1756)/Director" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Poster" 
type="application/atom+xml;type=entry" title="Poster" href="EntertainmentPrograms(1756)/Poster" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/MediaType" type="application/atom+xml;type=entry" 
title="MediaType" href="EntertainmentPrograms(1756)/MediaType" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ImageGalleryMaps"
 type="application/atom+xml;type=feed" title="ImageGalleryMaps" href="EntertainmentPrograms(1756)/ImageGalleryMaps" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/RelatedEntertainmentPrograms" type="application/atom+xml;type=feed" 
title="RelatedEntertainmentPrograms" href="EntertainmentPrograms(1756)/RelatedEntertainmentPrograms" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProgramToGameFormatMaps" type="application/atom+xml;type=feed" 
title="ProgramToGameFormatMaps" href="EntertainmentPrograms(1756)/ProgramToGameFormatMaps" /><category term="MediaModel.EntertainmentProgram" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /><content type="application/xml"><m:properties><d:Publishedid m:type="Edm.Int32">
1756</d:Publishedid><d:Title>JAWS</d:Title><d:DateCreated m:type="Edm.DateTime">1999-09-27T16:24:00</d:DateCreated><d:DateModified m:type="Edm.DateTime">
2011-11-29T14:25:00</d:DateModified><d:FirstReleasedYear m:type="Edm.Int16">1975</d:FirstReleasedYear><d:GameCategoryId m:type="Edm.Int32">-1
</d:GameCategoryId><d:GameWarningId m:type="Edm.Int32">-1</d:GameWarningId><d:MediaId m:type="Edm.Int32">0</d:MediaId><d:MusicAlbumTitle>
</d:MusicAlbumTitle><d:MusicCategoryId m:type="Edm.Int32">-1</d:MusicCategoryId><d:MusicRiaaId m:type="Edm.Int32">-1</d:MusicRiaaId>
<d:MusicWarningId m:type="Edm.Int32">-1</d:MusicWarningId><d:PromotesPublishedId m:type="Edm.Int32">-1</d:PromotesPublishedId>
<d:ProprietaryCustomerID m:type="Edm.Int32">-1</d:ProprietaryCustomerID><d:StreamLengthinseconds m:type="Edm.Int32">44</d:StreamLengthinseconds>
<d:MovieCategoryId m:type="Edm.Int32">6</d:MovieCategoryId><d:MovieMpaaId m:type="Edm.Int32">4</d:MovieMpaaId><d:MovieWarningId m:type="Edm.Int32">8
</d:MovieWarningId><d:BoxOfficeInMillions m:type="Edm.Double">0</d:BoxOfficeInMillions><d:MediaReceivedDate m:type="Edm.DateTime" m:null="true" />
<d:ExpirationDate m:type="Edm.DateTime" m:null="true" /><d:CountryOforiginId m:type="Edm.Int16">0</d:CountryOforiginId><d:LanguageId m:type="Edm.Int16">
0</d:LanguageId><d:OfficialSiteUrl></d:OfficialSiteUrl><d:OkToEncodeAndServe m:type="Edm.Boolean">true</d:OkToEncodeAndServe>
<d:IsATitle m:type="Edm.Boolean">false</d:IsATitle><d:Tagline></d:Tagline><d:Sequence m:type="Edm.Int16">-1</d:Sequence><d:OverallSequence m:type="Edm.Int16">-1
</d:OverallSequence><d:DisplayTitle>Jaws</d:DisplayTitle><d:NormalizedTitle>jaws</d:NormalizedTitle><d:TvCategoryid m:type="Edm.Int16">-1</d:TvCategoryid>
<d:TvRatingId m:type="Edm.Int16">-1</d:TvRatingId><d:HasIvaContent>true</d:HasIvaContent><d:HasYouTubeContent>false</d:HasYouTubeContent>
<d:CopyrightholderId m:type="Edm.Int32">63</d:CopyrightholderId><d:DirectorId m:type="Edm.Int32">7814</d:DirectorId><d:Rank1Day m:type="Edm.Int32">1000000</d:Rank1Day>
<d:Rank7Day m:type="Edm.Int32">1000000</d:Rank7Day><d:Rank30Day m:type="Edm.Int32">1000000</d:Rank30Day><d:RankAllTime m:type="Edm.Int32">1000000</d:RankAllTime>'
</m:properties></content></entry></feed>