Image
Contains information about an image and a URL to the image. Note: Access to images is governed by your subscription level and geographical location.
Elements
| Name | Type | Description |
|---|
| author | string | Creator (artist or photographer) credit, which may be a person or company. The credit may include the agency and image collection like this: creator/collection/agency.
IMPORTANT: The creator name must be displayed with the image. |
| copyrightOwner | string | Image owner credit, which may be a combination of creator/collection/owner.
IMPORTANT: For images from Getty Images, this credit must be displayed next to the image. If space prevents that, you may omit parts of the credit to show just Getty Images or Getty, provided the full credit is displayed at the next reasonable alternative location, even if that is on another screen, if that location exists. |
| formatid | integer | Rovi image format ID, which indicates the file format and the size of the bounding box that an image fills in one or both dimensions. See the Format IDs table. |
| height | integer | Vertical number of pixels. |
| imageTypeId | integer | Rovi image type ID, which indicates the type of image as shown in the Image Type IDs table. |
| url | string | Link to the image. |
| width | integer | Horizontal number of pixels. |
| zoomLevel | integer | Rovi image zoom level, which indicates the zoom level of image as shown in the Image Zoom Level table. |
XML Response Example
- Sample response with an author credit.
<Image>
<height>0</height>
<width>0</width>
<formatid>30</formatid>
<url>http://actual-url-concealed.jpg</url>
<author>20th Century Fox</author>
<copyrightOwner />
<imageTypeId>6</imageTypeId>
<zoomLevel>2<zoomLevel>
</Image>
XML Response Example 2
- Sample response with an author/company/agency credit.
<Image>
<height>0</height>
<width>0</width>
<formatid>26</formatid>
<url>http://actual-url-concealed.jpg</url>
<author>Henry Lamb/BEI/Rex Features</author>
<copyrightOwner />
<imageTypeId>6</imageTypeId>
<zoomLevel>2<zoomLevel>
</Image>
XML Response Example 3
- Sample response with a Getty Images copyright owner credit.
<Image>
<height>40</height>
<width>26</width>
<formatid>30</formatid>
<url>http://actual-url-concealed.jpg</url>
<author />
<copyrightOwner>Franco Origlia/Getty Images Entertainment/Getty Images</copyrightOwner>
<imageTypeId>6</imageTypeId>
<zoomLevel>2<zoomLevel>
</Image>
JSON Response Example
- Sample response with an author credit.
{
"height":0,
"width":0,
"formatid":30,
"url":"http:\/\/actual-url-concealed.jpg",
"author":"20th Century Fox",
"copyrightOwner":"",
"imageTypeId":6,
"zoomLevel":2
}
JSON Response Example 2
- Sample response with an author/company/agency credit.
{
"height":0,
"width":0,
"formatid":26,
"url":"http:\/\/actual-url-concealed.jpg",
"author":"Henry Lamb\/BEI\/Rex Features",
"copyrightOwner":"",
"imageTypeId":6,
"zoomLevel":2
}
JSON Response Example 3
- Sample response with a Getty Images copyright owner credit.
{
"height":40,
"width":26,
"formatid":30,
"url":"http:\/\/actual-url-concealed.jpg",
"author":"",
"copyrightOwner":"Franco Origlia\/Getty Images Entertainment\/Getty Images",
"imageTypeId":6,
"zoomLevel":2
}
-