General Information

A picture is worth a thousand words! Take advantage of IVA’s huge library of images and screen captures to create a stunning entertainment discovery experience.

Images are to be downloaded from IVA as per our Terms of Service. It is up to the client to manage, host, and serve the images they wish to use.

Be sure to check image availablity as images may be removed from the system at which point they should also be removed from the client system.

The Image API allows you to retrieve an image or a batch of images based on the FilePath. The FilePath's can be found inside the Entertainment API or the Celebrity API.

/Images/{FilePath}/Redirect Allows you to get a single image.
/Images/ScreenCaptures/Redirect Allows you to get one screen capture for a video asset.
/Images/Batch Allows you to get a batch of images by passing an array of FilePaths.
/Images/ScreenCaptures/Batch Allows you to get many video asset screen captures in one API call.

The examples below illustrate the types of images contained in the database.

Related API Guides: Entertainment API

Open API/Swagger documentation can be found on the Image API page.

“Promotional Use” of Images

Each image in our database is related to a specific movie, TV or game title and is promotional of that title. If you have title pages or articles about that title, then offering an image gallery on that page is obviously promotional. If you are doing editorial about another topic and use an image from IVA, you need to reference or otherwise indicate the title of the film, TV show or game so as to be promotional.


Image Types
  • Photo - Production Stills, Backdrops, Backgrounds, etc.
  • Poster - Poster for the program.
  • Portrait - Portraiat image of a person.
  • GetImageTypes - Returns full listing of types.
Screen Captures
  • Each still is handpicked by IVA.
  • Each still is picked from the video source.
  • Size of the image depends on the video source.
  • One still per video asset (4x3 & 16x9 versions available).

Example (FilePath 16x9 - "/content/hdphotos/10794/010794/010794_1280x720_241059_063.jpg")




Example (FilePath 4x3 - "/content/hdphotos/10794/010794/010794_960x720_241059_063.jpg")

Posters
  • IVA images feature a violence and a sexuality score to allow devlopers to filter out more graphic images if they choose.
  • IVA recommends using posters marked as “official” in the metadata.
  • Poster sizes and aspect ratios may vary.

Example (FilePath - "687eeacf6896176f1b3ef55bdfc2809b")

Photos
  • IVA images feature a violence and a sexualaity score to allow developers to filter out more graphic images if they choose.
  • IVA recommends using photos marked as “official” in the metadata.
  • Photo sizes and aspect ratios may vary.

Example (FilePath - "0269b128ddab3c05033345b4f3c1442e")

Portrait

Portraits of the person also include addtional metadata including face details and facial landmarks.

  • IVA images feature a violence and a sexualaity score to allow developers to filter out more graphic images if they choose.