Search editorial images
GET {{baseUrl}}/v2/editorial/images/search?country=<country-code-3>
This endpoint searches for editorial images. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter. You can also filter search terms out in the query parameter by prefixing the term with NOT.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | One or more search terms separated by spaces | |
sort | string | Sort by | |
category | string | Show editorial content within a certain editorial category; specify by category name | |
country | string | (Required) Show only editorial content that is available for distribution in a certain country | |
supplier_code | string | Show only editorial content from certain suppliers | |
date_start | string | Show only editorial content generated on or after a specific date | |
date_end | string | Show only editorial content generated on or before a specific date | |
per_page | number | Number of results per page | |
cursor | string | The cursor of the page with which to start fetching results; this cursor is returned from previous requests |
RESPONSES
status: OK
{"per_page":1,"total_count":1556949,"search_id":"q8igACM5gqQY75owjLoVvw","next":"eyJ2IjoxLCJzIjoxfQ==","prev":"","data":[{"id":"9804979n","title":"Hong Kong kicks off international e-Sports competition, China - 24 Aug 2018","caption":"","description":"Members of the TyLoo e-Sports team from China prepare to face off against the Kinguin e-Sports team from Poland at the ICBC (Asia) e-Sports and Music Festival Hong Kong 2018, Hong Kong, China, 24 August 2018. The festival runs from 24 to 26 August with professional gamers from around the world competing in international e-sports tournaments.","byline":"ALEX HOFFORD/EPA-EFE/Shutterstock","keywords":[],"date_taken":"2018-08-24","categories":[],"aspect":1.481,"assets":{"thumb_170":{"height":115,"width":170,"url":"https://editorial01.shutterstock.com/thumb/9804979n/c4377a53/Shutterstock_9804979n.jpg"},"thumb_220":{"height":149,"width":220,"url":"https://editorial01.shutterstock.com/thumb-220/9804979n/c57a68c7/Shutterstock_9804979n.jpg"},"watermark_450":{"height":304,"width":450,"url":"https://editorial01.shutterstock.com/wm-preview-450/9804979n/37d19dce/Shutterstock_9804979n.jpg"},"watermark_1500":{"height":1500,"width":1040,"url":"https://editorial01.shutterstock.com/wm-preview-1500/9933285a/ab82fea4/Shutterstock_9933285a.jpg"},"original":{"display_name":"Original","height":3263,"width":4831,"is_licensable":true},"small_jpg":{"display_name":"Small","height":337,"width":500,"is_licensable":true},"medium_jpg":{"display_name":"Med","height":675,"width":1000,"is_licensable":true}}}]}