--- title: "Search for editorial images only" method: GET path: "/v3/search/images/editorial" tags: ["Search"] --- # Search for editorial images only `GET /v3/search/images/editorial` Use this endpoint to search our editorial stock photos, illustrations and archival images. Editorial images represent newsworthy events or illustrate matters of general interest, such as news, sport and entertainment and are generally intended for editorial use. You'll need an API key and access token to use this resource. 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, and our [Authorization Workflows](https://github.com/gettyimages/gettyimages-api/blob/master/OAuth2Workflow.md) for code examples of getting a token. To include your API token in the search request, add it to the headers as a Bearer token (example in curl): -H "Authorization: Bearer " Search requests without a phrase parameter are not supported and may not always work. ## 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 image in your result set when you include **summary_set** in your request. ``` { "images": [ "asset_family", "caption", "collection_code", "collection_id", "collection_name", "display_sizes": [ { "name": "thumb" } ], "license_model", "max_dimensions", "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 images. The following fields are provided for every image in your result set when you include **detail_set** in your request. ``` { "images": [ "allowed_use", "artist", "asset_family", "call_for_image", "caption", "collection_code", "collection_id", "collection_name", "copyright", "date_created", "display_sizes": [ { "name": "comp" }, { "name": "preview" }, { "name": "thumb" } ], "editorial_segments", "event_ids", "graphical_style", "license_model", "max_dimensions", "orientation", "product_types", "quality_rank", "referral_destinations", "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 image 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. ``` { "images": [ "display_sizes": [ { "is_watermarked": , "name": "comp", "uri": "" }, { "is_watermarked": , "name": "preview", "uri": "" }, { "is_watermarked": , "name": "thumb", "uri": "" } ] ] } ``` ## Query parameters - `age_of_people` GettyImagesServicesConnectPublicControllersSearchModelAgeOfPeopleFilterType[] - `artists` string - `collection_codes` string[] - `collections_filter_type` 'include' | 'exclude' - `compositions` GettyImagesServicesConnectPublicControllersSearchModelCompositionsFilterType[] - `date_from` string, date-time - `date_to` string, date-time - `download_product` string - `editorial_segments` GettyImagesServicesConnectPublicModelsEditorialSegmentContract[] - `embed_content_only` boolean - `ethnicity` GettyImagesServicesConnectPublicControllersSearchModelEthnicityFilterType[] - `event_ids` integer[] - `exclude_keyword_ids` integer[] - `fields` GettyImagesServicesConnectPublicControllersSearchModelEditorialImagesFieldValues[] - `file_types` GettyImagesServicesConnectPublicControllersSearchModelSearchFileType[] - `graphical_styles` GettyImagesServicesConnectPublicControllersSearchModelEditorialGraphicalStyle[] - `graphical_styles_filter_type` 'include' | 'exclude' - `include_related_searches` boolean - `keyword_ids` integer[] - `minimum_size` 'x_small' | 'small' | 'medium' | 'large' | 'x_large' | 'xx_large' | 'vector' - `number_of_people` GettyImagesServicesConnectPublicControllersSearchModelNumberOfPeopleFilterType[] - `orientations` GettyImagesServicesConnectPublicModelsImageOrientationRequest[] - `page` integer - `page_size` integer - `phrase` string - `sort_order` 'best_match' | 'most_popular' | 'newest' | 'oldest' | 'random' - `specific_people` string[] - `minimum_quality_rank` integer - `facet_fields` GettyImagesServicesConnectPublicControllersSearchFacetsEditorialImageSearchFacetsFields[] - `include_facets` boolean - `facet_max_count` 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). - `GI-Country-Code` string — Use of this parameter requires configuration changes to your API key. Please contact your sales representative to learn more. ## Response `200` OK - GettyImagesServicesConnectPublicModelsSearchNewModelsSearchResponse1GettyImagesServicesConnectPublicModelsSearchNewModelsEditorialImage - `result_count` integer - `images` GettyImagesServicesConnectPublicModelsSearchNewModelsEditorialImage[], nullable - `istock_collection` string, nullable - `editorial_segments` string[], nullable - `editorial_source` GettyImagesServicesConnectPublicModelsSearchEditorialSource - `id` integer - `event_ids` integer[], nullable - `era` string, nullable - `people` string[], nullable - `istock_exclusive` boolean, 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 - `asset_family` string, nullable - `asset_type` string, nullable - `call_for_image` boolean, nullable - `caption` string, nullable - `collection_code` string, nullable - `collection_id` integer, nullable - `collection_name` string, nullable - `color_type` string, nullable - `contributor` GettyImagesServicesConnectPublicModelsContributor — Contributor information for an image or video - `member_name` string, nullable — The contributor's member name - `display_name` string, nullable — The contributor's display name - `copyright` string, nullable - `date_camera_shot` string, date-time, nullable - `date_created` string, date-time, nullable - `display_sizes` GettyImagesServicesConnectPublicModelsSearchImageSearchItemDisplaySize[], nullable - `is_watermarked` boolean - `name` string, nullable - `uri` string, nullable - `download_product` string, nullable - `download_sizes` GettyImagesServicesConnectPublicModelsImagesImageDownloadSize[], nullable - `bytes` integer - `downloads` GettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization[], nullable - `product_id` string, nullable - `product_type` string, nullable - `uri` string, nullable - `agreement_name` string, nullable - `height` integer - `media_type` string, nullable - `name` 'x_small' | 'small' | 'medium' | 'large' | 'x_large' | 'xx_large' | 'vector' - `width` integer - `dpi` integer - `graphical_style` string, nullable - `id` string, 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 - `max_dimensions` GettyImagesServicesConnectPublicModelsMaxDimensions - `height` integer - `width` integer - `orientation` string, nullable - `product_types` string[], nullable - `quality_rank` integer, nullable - `referral_destinations` GettyImagesServicesConnectPublicModelsReferralDestination[], nullable - `site_name` string, nullable - `uri` string, nullable - `territory_restrictions` GettyImagesServicesConnectPublicModelsTerritoryRestriction[], nullable - `country_code` string, nullable - `type` string, nullable - `description` string, nullable - `title` string, nullable - `uri_oembed` string, nullable - `date_submitted` string, date-time, 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 - `auto_corrections` GettyImagesServicesConnectPublicModelsSearchAutoCorrections - `phrase` string, nullable - `related_searches` GettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch[], nullable - `phrase` string, nullable - `url` string, nullable ## Other responses - `400` — InvalidParameterValue - `401` — AuthorizationTokenRequired - `403` — UnauthorizedDisplaySize --- [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/d069958d92a6/schema)