API Objects

Images

Visual representations in The Entertainment Graph®.

Recognizing an Image Object

All MediaHound Object Types can be inferred from the first five characters of their MHID or AltID. Here is a list of all Image types in The Entertainment Graph and their corresponding prefix.

Image Types

ImageMHID PrefixDescription
ImagemhimgA visual representation for an MHObject.

Overview

Most objects in The Entertainment Graph have images associated with them. You can use these images to represent any other API object in user-facing applications. Most images in The Entertainment Graph are high quality, but the API provides multiple sizes for you to choose the appropriate size based on performance and your application's needs. All images are in .jpg format.

Inappropriate Images

We do our best to ensure appropriate images for media content, but not all images will be appropriate for all ages.

Default Fields

All Image objects contain a set of fields. These fields contain information and sub-objects that relate directly to the essence of the Image object itself.

Copy
JSON
{
  "object": {
    "mhid": String,
    "name": String,
    "isDefault": Boolean,
    "original": {
      "url": String,
      "height": Integer,
      "width": Integer
    },
    "thumbnail": {
      "url": String,
      "height": Integer,
      "width": Integer
    },
    "small": {
      "url": String,
      "height": Integer,
      "width": Integer
    },
    "medium": {
      "url": String,
      "height": Integer,
      "width": Integer
    },
    "large": {
      "url": String,
      "height": Integer,
      "width": Integer
    }
  },
  "context":{}
}

Property Summary

PropertyDescription
mhidThe MediaHound ID of the Image.
nameThe name of the Image.
isDefaultIndicates whether the Image being returned is a default Image or an actual Image.
urlThe url of the Image.
heightThe height of the Image, in number of pixels.
widthThe width of the Image, in number of pixels.

Image Sizes

When requesting image data through the API, you will receive multiple URLs of the same image at various sizes. This lets you choose the optimal image to download for your applications. The sizes are listed below:

Image SizeDetails
originalThis is the best quality image.
thumbnailBoth width and height are less than 90 pixels.
smallBoth width and height are less than 180 pixels.
mediumBoth width and height are less than 360 pixels.
largeBoth width and height are less than 720 pixels.

The original image will always be the best quality. All other sizes are then scaled to fit under the listed thresholds. If the original size is under the threshold, the image is not scaled up.

Primary and Secondary Images

Most MediaHound Objects have something called a Primary Image. Many also have a Secondary Image. These are typically Images which we have selected as good Image candidates for most applications, but the specific context for each is described on the relevant API Object page. For example, see Media Primary Image or Contributor Primary Image.