--- title: "Retrieve similar videos" method: GET path: "/v3/videos/{id}/similar" tags: ["Videos"] --- # Retrieve similar videos `GET /v3/videos/{id}/similar` This endpoint will provide a list of videos that are similar to the specified asset id. You'll need an API key and access token to use this resource. ## 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", "call_for_image", "caption", "clip_length", "collection_code", "collection_id", "collection_name", "color_type", "copyright", "date_created", "display_sizes": [ { "name": "comp" }, { "name": "preview" }, { "name": "thumb" } ], "download_sizes", "era", "event_ids", "license_model", "mastered_to", "originally_shot_on", "product_types", "quality_rank", "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. The URI provided is subject to change at any time and must be used as-is with no modification. ``` { "videos": [ "display_sizes": [ { "is_watermarked": , "name": "comp", "uri": "" }, { "is_watermarked": , "name": "preview", "uri": "" }, { "is_watermarked": , "name": "thumb", "uri": "" } ] ] } ``` ## Path parameters - `id` string, required ## Query parameters - `fields` GettyImagesServicesConnectPublicControllersVideosAssociatedVideoDetailFieldValues[] - `page` integer - `page_size` integer ## Headers - `Accept-Language` string — Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only). ## Response `200` OK - GettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideoSearchResponse1GettyImagesServicesConnectPublicModelsSearchNewModelsVideoEditorialVideo - `videos` GettyImagesServicesConnectPublicModelsSearchNewModelsVideoEditorialVideo[], nullable - `editorial_segments` string[], nullable - `editorial_source` GettyImagesServicesConnectPublicModelsSearchEditorialSource - `id` integer - `era` string, nullable - `event_ids` integer[], nullable - `people` string[], nullable - `source` string, nullable - `id` string, nullable - `allowed_use` GettyImagesServicesConnectPublicModelsAllowedUse - `how_can_i_use_it` string, nullable — Indicates how the asset can be used - `release_info` string, nullable — Indicates release status - `usage_restrictions` string[], nullable — Indicates asset usage restriction, if any - `editorial_use_only` boolean — Indicates whether the asset is for editorial use only - `alternative_ids` object, nullable - `artist` string, nullable - `aspect_ratio` string, nullable - `asset_family` string, nullable - `asset_type` string, nullable - `call_for_image` boolean, nullable - `caption` string, nullable - `clip_length` string, nullable - `collection_id` integer, nullable - `collection_code` string, nullable - `collection_name` string, nullable - `color_type` string, nullable - `copyright` string, nullable - `date_camera_shot` string, date-time, nullable - `date_created` string, date-time, nullable - `date_submitted` string, date-time, nullable - `display_sizes` GettyImagesServicesConnectPublicModelsSearchVideoSearchItemDisplaySize[], nullable - `is_watermarked` boolean - `name` string, nullable - `uri` string, nullable - `aspect_ratio` string, nullable - `download_product` string, nullable - `download_sizes` GettyImagesServicesConnectPublicModelsVideosVideoDownloadSize[], nullable - `bit_depth` string, nullable - `broadcast_video_standard` string, nullable - `compression` string, nullable - `content_type` string, nullable - `description` string, nullable - `downloads` GettyImagesServicesConnectPublicModelsVideosVideoDownloadAuthorization[], nullable - `product_id` string, nullable - `product_type` string, nullable - `uri` string, nullable - `agreement_name` string, nullable - `format` string, nullable - `frame_rate` number, double, nullable - `frame_size` string, nullable - `height` number, double, nullable - `interlaced` boolean - `bytes` integer - `name` string, nullable - `width` integer - `istock_collection` string, nullable - `istock_exclusive` boolean, nullable - `keywords` GettyImagesServicesConnectPublicModelsKeyword[], nullable - `keyword_id` string, nullable - `text` string, nullable - `type` string, nullable - `relevance` integer, nullable - `largest_downloads` GettyImagesServicesConnectPublicModelsDownload[], nullable - `product_id` string, nullable - `product_type` string, nullable - `uri` string, nullable - `agreement_name` string, nullable - `license_model` string, nullable - `mastered_to` string, nullable - `max_dimensions` GettyImagesServicesConnectPublicModelsMaxDimensions - `height` integer - `width` integer - `orientation` string, nullable - `originally_shot_on` string, nullable - `product_types` string[], nullable - `quality_rank` integer, nullable - `referral_destinations` GettyImagesServicesConnectPublicModelsReferralDestination[], nullable - `site_name` string, nullable - `uri` string, nullable - `shot_speed` string, nullable - `title` string, nullable - `istock_licenses` GettyImagesServicesConnectPublicModelsIStockLicense[], nullable - `license_type` 'Standard' | 'Multiseat' | 'Unlimited' | 'Resale' | 'Indemnification' - `credits` integer - `object_name` string, nullable - `facets` GettyImagesServicesConnectPublicControllersSearchFacetsSearchFacetsResponse - `specific_people` GettyImagesServicesConnectPublicControllersSearchFacetsSpecificPeople[], nullable - `id` integer - `name` string, nullable - `events` GettyImagesServicesConnectPublicControllersSearchFacetsFacetEvent[], nullable - `id` integer - `name` string, nullable - `date` string, date-time - `locations` GettyImagesServicesConnectPublicControllersSearchFacetsLocation[], nullable - `id` integer - `name` string, nullable - `artists` GettyImagesServicesConnectPublicControllersSearchFacetsArtist[], nullable - `name` string, nullable - `entertainment` GettyImagesServicesConnectPublicControllersSearchFacetsEntertainment[], nullable - `id` integer - `name` string, nullable - `related_searches` GettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch[], nullable - `phrase` string, nullable - `url` string, nullable - `result_count` integer - `auto_corrections` GettyImagesServicesConnectPublicModelsSearchAutoCorrections - `phrase` string, nullable ## Other responses - `400` — InvalidParameterValue - `401` — AuthorizationTokenRequired - `403` — UnauthorizedDisplaySize - `404` — VideosNotFound - `500` — InvalidIStockCollection --- [API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/29f239eeae86/schema)