Celebrity images
/celebs/:personId/images
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. See Image Sizing for details. If not specified, all available image sizes will be returned. |
|
imageAspectTV |
No |
Requested aspect ratio (horizontal by vertical) for TV show images |
|
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
http://data.tmsapi.com/v1.1/celebs/55541/images?api_key=1234567890Sample Response
[{
"width": "1080",
"height": "1440",
"caption": {
"content": "Hugh Laurie"
},
"uri": "v9/AllPhotos/87269/87269_v9_ba.jpg",
"size": "Ms",
"aspect": "3x4",
"category": "Photo - headshot",
"text": "no"
}, {
"width": "540",
"height": "720",
"caption": {
"content": "Hugh Laurie"
},
"uri": "v4/AllPhotos/87269/87269_v4_ba.jpg",
"size": "Lg",
"aspect": "3x4",
"category": "Photo - headshot",
"text": "no"
}, {
"width": "270",
"height": "360",
"caption": {
"content": "Hugh Laurie"
},
"uri": "v3/AllPhotos/87269/87269_v3_ba.jpg",
"size": "Md",
"aspect": "3x4",
"category": "Photo - headshot",
"text": "no"
}, {
"width": "135",
"height": "180",
"caption": {
"content": "Hugh Laurie"
},
"uri": "v2/AllPhotos/87269/87269_v2_ba.jpg",
"size": "Sm",
"aspect": "3x4",
"category": "Photo - headshot",
"text": "no"
}, {
"width": "270",
"height": "360",
"caption": {
"content": "Hugh Laurie as Dr. Gregory House",
"lang": "en"
},
"title": "House",
"seriesId": "185044",
"uri": "assets/p185044_n87269_cc_v3_aa.jpg",
"size": "Md",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "540",
"height": "720",
"caption": {
"content": "Hugh Laurie as Dr. Gregory House",
"lang": "en"
},
"title": "House",
"seriesId": "185044",
"uri": "assets/p185044_n87269_cc_v4_aa.jpg",
"size": "Lg",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "135",
"height": "180",
"caption": {
"content": "Hugh Laurie as Dr. Gregory House",
"lang": "en"
},
"title": "House",
"seriesId": "185044",
"uri": "assets/p185044_n87269_cc_v2_aa.jpg",
"size": "Sm",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "1080",
"height": "1440",
"caption": {
"content": "Hugh Laurie as Dr. Gregory House",
"lang": "en"
},
"title": "House",
"seriesId": "185044",
"uri": "assets/p185044_n87269_cc_v9_aa.jpg",
"size": "Ms",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "432",
"height": "288",
"caption": {
"content": "(Top, L-R) Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Hugh Laurie as Mr. Fredrick Little. (Bottom, L-R) Snowball and Stuart in \"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ab.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}, {
"width": "108",
"height": "72",
"caption": {
"content": "(Top, L-R) Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Hugh Laurie as Mr. Fredrick Little. (Bottom, L-R) Snowball and Stuart in \"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ab_t.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}, {
"width": "432",
"height": "288",
"caption": {
"content": "(Top-Clockwise) Hugh Laurie as Mr. Fredrick Little, Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Stuart Little in \"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ac.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no",
"primary": "true"
}, {
"width": "108",
"height": "72",
"caption": {
"content": "(L-R) Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Hugh Laurie as Mr. Fredrick Little in\"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ai_t.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}, {
"width": "432",
"height": "288",
"caption": {
"content": "(L-R) Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Hugh Laurie as Mr. Fredrick Little in\"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ai.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}, {
"width": "108",
"height": "72",
"caption": {
"content": "(Top-Clockwise) Hugh Laurie as Mr. Fredrick Little, Geena Davis as Mrs. Eleanor Little, Jonathan Lipnicki as George Little and Stuart Little in \"Stuart Little.\"",
"lang": "en"
},
"title": "Stuart Little",
"seriesId": "659962",
"rootId": "24380",
"uri": "assets/21633_ac_t.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no",
"primary": "true"
}, {
"width": "1440",
"height": "1080",
"caption": {
"content": "Tim McInnerny, Stephen Fry, Hugh Laurie, Tony Robinson and Rowan Atkinson (clockwise from top left)"
},
"title": "Blackadder Goes Forth",
"seriesId": "341640",
"rootId": "341836",
"uri": "assets/p341836_ce_h9_aa.jpg",
"size": "Ms",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "267",
"height": "200",
"caption": {
"content": "Tim McInnerny, Stephen Fry, Hugh Laurie, Tony Robinson and Rowan Atkinson (clockwise from top left)"
},
"title": "Blackadder Goes Forth",
"seriesId": "341640",
"rootId": "341836",
"uri": "assets/p341836_ce_h7_aa.jpg",
"size": "",
"aspect": "",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "180",
"height": "135",
"caption": {
"content": "Tim McInnerny, Stephen Fry, Hugh Laurie, Tony Robinson and Rowan Atkinson (clockwise from top left)"
},
"title": "Blackadder Goes Forth",
"seriesId": "341640",
"rootId": "341836",
"uri": "assets/p341836_ce_h5_aa.jpg",
"size": "Sm",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "720",
"height": "540",
"caption": {
"content": "Tim McInnerny, Stephen Fry, Hugh Laurie, Tony Robinson and Rowan Atkinson (clockwise from top left)"
},
"title": "Blackadder Goes Forth",
"seriesId": "341640",
"rootId": "341836",
"uri": "assets/p341836_ce_h6_aa.jpg",
"size": "Lg",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "360",
"height": "270",
"caption": {
"content": "Tim McInnerny, Stephen Fry, Hugh Laurie, Tony Robinson and Rowan Atkinson (clockwise from top left)"
},
"title": "Blackadder Goes Forth",
"seriesId": "341640",
"rootId": "341836",
"uri": "assets/p341836_ce_h3_aa.jpg",
"size": "Md",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "540",
"height": "720",
"caption": {
"content": "Hugh Laurie as Prince of Wales"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_n87269_cc_v4_aa.jpg",
"size": "Lg",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "180",
"height": "135",
"caption": {
"content": "Rowan Atkinson, Hugh Laurie, Helen Atkinson-Wood and Tony Robinson (clockwise from left)"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_ce_h5_aa.jpg",
"size": "Sm",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "1440",
"height": "1080",
"caption": {
"content": "Rowan Atkinson, Hugh Laurie, Helen Atkinson-Wood and Tony Robinson (clockwise from left)"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_ce_h9_aa.jpg",
"size": "Ms",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "720",
"height": "540",
"caption": {
"content": "Rowan Atkinson, Hugh Laurie, Helen Atkinson-Wood and Tony Robinson (clockwise from left)"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_ce_h6_aa.jpg",
"size": "Lg",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "135",
"height": "180",
"caption": {
"content": "Hugh Laurie as Prince of Wales"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_n87269_cc_v2_aa.jpg",
"size": "Sm",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "270",
"height": "360",
"caption": {
"content": "Hugh Laurie as Prince of Wales"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_n87269_cc_v3_aa.jpg",
"size": "Md",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "267",
"height": "200",
"caption": {
"content": "Rowan Atkinson, Hugh Laurie, Helen Atkinson-Wood and Tony Robinson (clockwise from left)"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_ce_h7_aa.jpg",
"size": "",
"aspect": "",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "1080",
"height": "1440",
"caption": {
"content": "Hugh Laurie as Prince of Wales"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_n87269_cc_v9_aa.jpg",
"size": "Ms",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "360",
"height": "270",
"caption": {
"content": "Rowan Atkinson, Hugh Laurie, Helen Atkinson-Wood and Tony Robinson (clockwise from left)"
},
"title": "Blackadder the Third",
"seriesId": "341640",
"rootId": "341839",
"uri": "assets/p341839_ce_h3_aa.jpg",
"size": "Md",
"aspect": "4x3",
"category": "Cast Ensemble",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "1080",
"height": "1440",
"caption": {
"content": "Hugh Laurie as Bertie Wooster",
"lang": "en"
},
"title": "Jeeves and Wooster",
"seriesId": "411743",
"uri": "assets/p411743_n87269_cc_v9_aa.jpg",
"size": "Ms",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "540",
"height": "720",
"caption": {
"content": "Hugh Laurie as Bertie Wooster",
"lang": "en"
},
"title": "Jeeves and Wooster",
"seriesId": "411743",
"uri": "assets/p411743_n87269_cc_v4_aa.jpg",
"size": "Lg",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "270",
"height": "360",
"caption": {
"content": "Hugh Laurie as Bertie Wooster",
"lang": "en"
},
"title": "Jeeves and Wooster",
"seriesId": "411743",
"uri": "assets/p411743_n87269_cc_v3_aa.jpg",
"size": "Md",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "135",
"height": "180",
"caption": {
"content": "Hugh Laurie as Bertie Wooster",
"lang": "en"
},
"title": "Jeeves and Wooster",
"seriesId": "411743",
"uri": "assets/p411743_n87269_cc_v2_aa.jpg",
"size": "Sm",
"aspect": "3x4",
"category": "Cast in Character",
"text": "no",
"primary": "true",
"tier": "Series"
}, {
"width": "432",
"height": "288",
"caption": {
"content": "A brave-but-undersized pidgeon named Valiant (center, voiced by Ewan McGregor) gets a chance to meet his hero, the much-decorated Wing Commander Gutsy (center right, voiced by Hugh Laurie).",
"lang": "en"
},
"title": "Valiant",
"seriesId": "547242",
"rootId": "86834",
"uri": "assets/43610_ba.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}, {
"width": "108",
"height": "72",
"caption": {
"content": "A brave-but-undersized pidgeon named Valiant (center, voiced by Ewan McGregor) gets a chance to meet his hero, the much-decorated Wing Commander Gutsy (center right, voiced by Hugh Laurie).",
"lang": "en"
},
"title": "Valiant",
"seriesId": "547242",
"rootId": "86834",
"uri": "assets/43610_ba_t.jpg",
"size": "",
"aspect": "",
"category": "Screen Still",
"text": "no"
}]