Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
editorial_images

(Deprecated) Search editorial content

Deprecated; use GET /v2/editorial/images/search instead to search for editorial images.

get/v2/editorial/search

Query parameters

querystring

One or more search terms separated by spaces

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

Sort by

categorystring

Show editorial content within a certain editorial category; specify by category name

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

OK

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