v1

latestOpenAPI 3.0.02026-07-131091452.6 MB

editorial_images

Search editorial images

This endpoint searches for editorial images. If you specify more than one search parameter, the API uses an AND condition. For example, if you set the category parameter to "Alone,Performing" and also specify a query parameter, the results include only images that match the query and are in both the Alone and Performing categories. You can also filter search terms out in the query parameter by prefixing the term with NOT.

get/v2/editorial/images/search

Query parameters

querystring

One or more search terms separated by spaces

sort'relevant' | 'newest' | 'oldest'

Sort by

categorystring

Show editorial content with each of the specified editorial categories; specify category names in a comma-separated list

countrystring country-code-3 required

Show only editorial content that is available for distribution in a certain country

supplier_codestring[]

Show only editorial content from certain suppliers

date_startstring date

Show only editorial content generated on or after a specific date

date_endstring date

Show only editorial content generated on or before a specific date

per_pageinteger

Number of results per page

cursorstring

The cursor of the page with which to start fetching results; this cursor is returned from previous requests

Response

messagestring

Optional error message

nextstring

Cursor value that represents the next page of results

pageinteger

Current page of the response

per_pageinteger

Number of results per page

prevstring

Cursor value that represents the previous page of results

search_idstring

Unique identifier for the search request

total_countinteger required

Total count of all results

Example response

{
  "per_page": 1,
  "total_count": 46845,
  "search_id": "BaMzOAkpHIvfnuWVRFs1ag",
  "next": "eyJ2IjoyLCJzIjoxLCJwIjpbMF19",
  "prev": "",
  "data": [
    {
      "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
        }
      }
    }
  ]
}