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
Image | MHID Prefix | Description |
---|---|---|
Image | mhimg | A 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.
{"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
Property | Description |
---|---|
mhid | The MediaHound ID of the Image. |
name | The name of the Image. |
isDefault | Indicates whether the Image being returned is a default Image or an actual Image. |
url | The url of the Image. |
height | The height of the Image, in number of pixels. |
width | The 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:
Property Summary
Image Size | Details |
---|---|
original | This is the best quality image. |
thumbnail | Both width and height are less than 90 pixels. |
small | Both width and height are less than 180 pixels. |
medium | Both width and height are less than 360 pixels. |
large | Both 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.