Images

Marvel comics are famous for their iconic images, and we have provided a number of options for developers in order to optimally present images to your application's users. As always, consult the terms of use and follow the attribution guidelines when displaying images in an application or website.

Image Representations and Pathing

The Marvel Comics API does not provide full paths to images. Instead, images are represented as a partial path to an image file and the canonical extension of that file. Developers may select from a set of image variants (predefined sizes and ratios) in order to best serve the presentation of their web site or application.

To build a full image path from an image representation:

    1. Take the path key from the image representation.
    2. Append a variant name to the path key.
    3. Append the extension key to the variant name.

For example, to display the image represented here:

"thumbnail": {\n\s\s"path": "http://i.annihil.us/u/prod/marvel/i/mg/3/40/4bb4680432f73",\n\s\s"extension": "jpg"\n}    
    1. Take the path element: http://i.annihil.us/u/prod/marvel/i/mg/3/40/4bb4680432f73
    2. Select an image variant name (see the full list below) and append the variant name to the path element: http://i.annihil.us/u/prod/marvel/i/mg/3/40/4bb4680432f73/portrait_xlarge
    3. Append the extension: http://i.annihil.us/u/prod/marvel/i/mg/3/40/4bb4680432f73/portrait_xlarge.jpg
    4. In order to make your web site or application load and respond quickly and preserve end-user bandwidth, we recommend using the smallest-sized image necessary to meet the needs our user interface.

Image Variants

The following named image sizes and ratios are available for you use products leveraging the Marvel API. We add new image sizes from time to time, so please check this page in the future.

Portrait aspect ratio
name size
portrait_small 50x75px
portrait_medium 100x150px
portrait_xlarge 150x225px
portrait_fantastic 168x252px
portrait_uncanny 300x450px
portrait_incredible 216x324px
Standard (square) aspect ratio
name size
standard_small 65x45px
standard_medium 100x100px
standard_large 140x140px
standard_xlarge 200x200px
standard_fantastic 250x250px
standard_amazing 180x180px
Landscape aspect ratio
name size
landscape_small 120x90px
landscape_medium 175x130px
landscape_large 190x140px
landscape_xlarge 270x200px
landscape_amazing 250x156px
landscape_incredible 464x261px
Full size images
name size
detail full image, constrained to 500px wide
full-size image no variant descriptor