The Image API allows access to our database of image stills for movie
titles and performers.
The link to access this API is: http://api.internetvideoarchive.com/Common/Photos.aspx
Note:
You must be registered with a developer account in order to use this.
If you do not have one, you can register by going to http://www.internetvideoarchive.com/IVA/Support
Parameters:
SearchTerm
- The IVA Published ID, IVA Performer ID, Category ID, or Date Since modified to look-up images.
SearchFor - 0 (default) for
Published ID search, 1 for Performer ID search, 2 for Category ID search, 3 for Date Since search.
| Category IDs |
| Note: Specifying a category ID that is a parent will include images from all child categories. |
Category ID
| Parent Category ID
| Category Name
| Description
|
| 1 | Parent
| Packaged | Images depicting the covers of any packaged goods.
|
2
| 1
| DVD Cover
| DVD cover.
|
3
| 1
| Blu-Ray Cover
| Blu-Ray cover.
|
4
| Parent
| Poster
| Poster art.
|
5
| 4
| Theatrical Poster
| Theatrical poster art.
|
6
| Parent
| Publicity
| All photos supplied for promotion.
|
7
| 6
| Press
| Press photos.
|
8
| 6
| Production
| Images taken on set during production.
|
9
| 6
| Non-Production
| Images taken off set and not during production.
|
10
| Parent
| Screen Capture
| Images taken from video footage.
|
11
| 10
| In Game
| Images from game footage of live play or introductions.
|
Page - 1 (default) - Use to page through results.
PageSize - 20 (default) - Use to set page size of results (max 50).
DeveloperID - You get this when you register for a developer account.
| Example Usage: This will retrieve images that are available for a performer with the ID
4311.
http://api.internetvideoarchive.com/Common/Photos.aspx?SearchTerm=4311&SearchFor=1&DeveloperId=dev_id This will retrieve images that are available for a movie with the ID 576682.
http://api.internetvideoarchive.com/Common/Photos.aspx?SearchTerm=576682&DeveloperId=dev_id
Return Feed:
The return feed
looks similar to this: <?xml version="1.0" encoding="utf-8"?>
<items Page="1" PageSize="50" PageCount="1" TotalRecordCount="80">
<item>
<ID>233</ID>
<Description />
<Credit />
<Category>Production</Category>
<CategoryId>8</CategoryId>
<Images> <Image>http://content.internetvideoarchive.com/content/graphics/005/000233/0.jpg</Image>
<Image>http://content.internetvideoarchive.com/content/graphics/005/000233/1.jpg</Image>
<Image>http://content.internetvideoarchive.com/content/graphics/005/000233/2.jpg</Image>
</Images>
<Titles>
<Title ID="565673">PUBLIC ENEMIES</Title>
</Titles> <Performers>
<Performer ID="4311">Johnny Depp</Performer>
</Performers>
</item>
</items>
Every
item returned correlates to a unique image in our database.
|
ID:
A unique Image ID that identifies the image.
Description: A
description of the image if available.
Credit: A image credit that should be displayed along with the image if available.
Category:
The textual category name for the image.
CategoryId: The
numeric category identifier for the image.
Images/Image:
Each <Image> tag designates size/quality variations of the image.
0.jpg
- This is the source version of the image. Full resolution, no width
and height restrictions. This will carry the highest file size.
1.jpg
- This is a thumbnail version of the image at 100x100 size.
2.jpg
- This is a smaller version of the source with a max width of 600 and
max height of 400.
Titles/Title: Each <Title> tag designates
any titles related to this image and their IDs (Published ID).
Performers/Performer:
Each <Performer> tag designates any performers related to this image and their IDs (Performer ID).