Celebrities
Celebrity images
/celebs/
Returns all available image references and image metadata associated with specified celebrity. Available images are headshots, cast ensemble, and cast in character. Cast images will be returned for TV credits, where available. Movie cast images are not currently available.
Request Parameters
| Parameter | Mandatory? | Description |
|---|---|---|
| personId | Yes | Celebrity resource identifier |
| imageSize | No | Requested size of image returned in preferredImage URI. Valid values are: Sm, Md, Lg, Ms. If not specified, all available image sizes will be returned. |
| imageAspectTV | No | Requested aspect ratio (horizontal by vertical) for TV show images. Valid values are: 2x3, 3x4, 4x3, 16x9. If not specified, all available aspect ratios will be returned. |
| api_key | Yes | 24-character key obtained during application registration |
Response Body
| Response | Description |
|---|---|
| uri | relative path to image source file |
| height | image height, in pixels |
| width | image width, in pixels |
| primary | primary=true indicates preferred image; if field not present, indicates secondary image |
| category | image type (e.g., Logo, Banner, Poster, Cast Ensemble) |
| caption | Image caption, where available. Currently returned only in English. |
| content | Caption text; may include title, person name, year |
| lang | 2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish); see Language Code reference for full listing of codes |
| rootId | for cast images, rootId of TV show or episode associated with images. |
| seriesId | for cast images, seriesId associated with images, where applicable |
| title | for cast images,title of TV show or episode associated with images |
Sample Request
Code
Sample Response
Code
Last modified on