v1

latestOpenAPI 3.0.02026-07-131091452.6 MB

editorial_images

Get editorial content details

This endpoint shows information about an editorial image, including a URL to a preview image and the sizes that it is available in.

get/v2/editorial/images/{id}

Path parameters

idstring required

Editorial ID

Query parameters

countrystring country-code-3 required

Returns only if the content is available for distribution in a certain country

Response

aspectnumber

bylinestring

captionstring

date_takenstring date

descriptionstring

idstring required

keywordsstring[]

special_instructionsstring

titlestring

Example response

{
  "id": "10687730b",
  "title": "Soccer Premier League, Manchester, United Kingdom - 11 May 2021",
  "caption": "",
  "description": "Security and stewards stand outside the Old Trafford stadium in Manchester, England, ahead of the English Premier League soccer match between Manchester United and Leicester City. This is the first Manchester United home match since fans protested against American owner Joel Glazer, forcing the postponement of the team's Premier League game against Liverpool. The protests prompted Glazer to publish a letter in which he pledged to accelerate discussions with fans about supporters being able to have a greater say at the club",
  "byline": "Jon Super/AP/Shutterstock",
  "keywords": [
    "england",
    "europe",
    "leicester city fc",
    "manchester",
    "manchester united fc",
    "men's soccer",
    "men's sports",
    "premier league",
    "professional soccer",
    "soccer",
    "sports",
    "united kingdom",
    "western europe",
    "wsoc"
  ],
  "date_taken": "2021-05-11",
  "categories": [
    {
      "name": "Sport"
    }
  ],
  "aspect": 1.621,
  "assets": {
    "thumb_170": {
      "height": 105,
      "width": 170,
      "url": "https://editorial01.shuttercorp.net/thumb/10687730b/272a999e/Shutterstock_10687730b.jpg"
    },
    "thumb_220": {
      "height": 136,
      "width": 220,
      "url": "https://editorial01.shuttercorp.net/thumb-220/10687730b/927a6ebe/Shutterstock_10687730b.jpg"
    },
    "watermark_450": {
      "height": 278,
      "width": 450,
      "url": "https://editorial01.shuttercorp.net/wm-preview-450/10687730b/ff2443ad/Shutterstock_10687730b.jpg"
    },
    "watermark_1500": {
      "height": 926,
      "width": 1500,
      "url": "https://editorial01.shuttercorp.net/wm-preview-1500/10687730b/ee2d7ae1/Shutterstock_10687730b.jpg"
    },
    "small_jpg": {
      "display_name": "Small",
      "width": 500,
      "height": 309,
      "is_licensable": true
    },
    "medium_jpg": {
      "display_name": "Med",
      "width": 1000,
      "height": 617,
      "is_licensable": true
    },
    "original": {
      "display_name": "Original",
      "height": 3693,
      "width": 5985,
      "is_licensable": true
    }
  }
}