• Register

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
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

http://data.tmsapi.com/v1.1/celebs/55541/images?api_key=1234567890

Sample 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"
}]