Getty Images Search for creative videos

Getty Images - Search for creative videos

Use this endpoint to search premium stock video, from archival film to contemporary 4K and HD footage. You'll need an API key and access token to use this resource. Please see our [Getting Started](http://developers.gettyimages.com/en/getting-started.html) page for more information on how to sign up for an API key. You can show different information in the response by specifying values on the "fields" parameter (see details below). You can search with only an API key, and that will give you search results that are equivalent to doing a search on the GettyImages.com site without being logged in (anonymous search). If you are a Getty Images API customer and would like to ensure that your API searches return only assets that you have a license to use, you need to also include an authorization token in the header of your request. Please consult our [Authorization FAQ](http://developers.gettyimages.com/en/authorization-faq.html) for more information on authorization tokens. ## Working with Fields Sets Fields sets are used in the **fields** request parameter to receive a suite of metadata fields. The following fields sets are available: #### Summary Fields Set The **summary_set** query string parameter fields value represents a small batch of metadata fields that are often used to build search response results. The following fields are provided for every video in your result set when you include **summary_set** in your request. ``` { "videos": [ "asset_family", "caption", "collection_code", "collection_name", "display_sizes": [ { "name": "comp" }, { "name": "preview" }, { "name": "thumb" } ], "license_model", "title" ] } ``` #### Detail Fields Set The **detail_set** query string parameter fields value represents a large batch of metadata fields that are often used to build a detailed view of videos. The following fields are provided for every video in your result set when you include **detail_set** in your request. ``` { "videos": [ "allowed_use", "artist", "asset_family", "caption", "clip_length", "collection_code", "collection_id", "collection_name", "color_type", "copyright", "date_created", "display_sizes": [ { "name": "comp" }, { "name": "preview" }, { "name": "thumb" } ], "era", "license_model", "mastered_to", "originally_shot_on", "product_types", "shot_speed", "source", "title" ] } ``` #### Display Fields Set The **display_set** query string parameter fields value represents the fields that provide you with URLs for the low resolution files that are most frequently used to build a UI displaying search results. The following fields are provided for every video in your result set when you include **display_set** in your request. ``` { "videos": [ "display_sizes": [ { "name": "comp" }, { "name": "preview" }, { "name": "thumb" } ] ] } ```

Posted on:

2018-08-28

API Description

Provider

Getty Images

decription

Find high resolution royalty-free images, editorial stock photos, vector art, video footage clips and stock music licensing at the richest image search photo library online.

Curl command through Streamdata.io

curl -v -h "header{header_value}" -h "header{header_value}""https://streamdata.motwin.net/http://api.gettyimages.comv3/search/videos/creative?X-Sd-Token={streamdata_token}&age_of_people={field_value}&collections_filter_type={field_value}&collection_codes={field_value}&exclude_nudity={field_value}&fields={field_value}&format_available={field_value}&frame_rates={field_value}&keyword_ids={field_value}&license_models={field_value}&page={field_value}&page_size={field_value}&phrase={field_value}&product_types={field_value}&sort_order={field_value}"



Return to Main Page



Submit Your API

Join the gallery to find out how much you can save with Streamdata.io.