Search editorial video content
GET {{baseUrl}}/v2/editorial/videos/search?country=<country-code-3>
This endpoint searches for editorial videos. 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 video content within a certain editorial category; specify by category name | |
country | string | (Required) Show only editorial video content that is available for distribution in a certain country | |
supplier_code | string | Show only editorial video content from certain suppliers | |
date_start | string | Show only editorial video content generated on or after a specific date | |
date_end | string | Show only editorial video content generated on or before a specific date | |
resolution | string | Show only editorial video content with specific resolution | |
fps | string | Show only editorial video content generated with specific frames per second | |
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 |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
User-Agent | string |
RESPONSES
status: OK
{"per_page":1,"total_count":1556949,"search_id":"q8igACM5gqQY75owjLoVvw","next":"eyJ2IjoxLCJzIjoxfQ==","prev":"","data":[{"id":"10679336a","title":"Proud Papa Playing with His Puppies, New Oxford, Pennsylvania, USA - 28 Oct 2020","caption":"","description":"Info from Licensor: \"In June, we rescued this 2 year old male boxer from spending most of his days in a crate. Our 2 adult female boxers helped him adjust to living a good boxer life with our family. He \"thanked\" us with this surprise litter of 8 puppies! He has really done amazingly well with playing with all the puppies, and I think he will miss them when they go to their \"fur-ever\" homes. It was a perfect day of playing in the backyard at the end of October 2020.\"","byline":"ViralHog/Shutterstock","keywords":["adorable","cute","doggo","doggy","dogs","domesticated animals","entertainment","feel good","grass","new oxford","pennsylvania","pets","played","playing","plays","pup","puppies","puppy","sweet","usa","viralhog","virals","yard"],"date_taken":"2020-10-28","categories":[],"aspect":1.778,"assets":{"preview_mp4":{"url":"https://qa.editorial-cdn.shuttercorp.net/wm-preview-mp4/10679336a/M8TbAb3aNaj2g5w4ODgwMzg=/Shutterstock_10679336a.mp4"},"preview_webm":{"url":"https://qa.editorial-cdn.shuttercorp.net/wm-preview-webm/10679336a/M5T3Ab36N4jbgcwbODgwMzg=/Shutterstock_10679336a.webm"},"thumb_jpg":{"url":"https://qa.editorial-cdn.shuttercorp.net/thumb-1/10679336a/M5T6Ad37Ncj5g3w1ODgwMzg=/Shutterstock_10679336a.jpg"},"original":{"height":1080,"width":1920,"fps":29.937,"format":"avc1","file_size":124452018,"display_name":"HD","is_licensable":true}}}]}