Asset Metadata
Getty Images Asset Metadata
The following are descriptions of the various image metadata fields provided by the Getty Images API. For the latest fields, and to see what they return, use our interactive documentation in Swagger.
Metadata field name | Images endpoint | Image search endpoint | Description |
---|---|---|---|
allowed_use |
✅ | ✅ | Container for info on release/use status. Most customers do not need to use this info. |
artist |
✅ | ✅ | Name of the photographer/illustrator |
artist_title |
✅ | Not used at this time | |
asset_family |
✅ | ✅ | Indicates if the asset is Editorial or Creative |
call_for_image |
✅ | ✅ | Indicates if the high res file for the asset can only be obtained by calling your sales rep. This restriction is rare and typically only appears with Editorial assets. |
caption |
✅ | ✅ | Provides the full caption for the asset. Not all assets will have captions. |
city |
✅ | Name of the city, if known, in which the asset was created. Typically only relevant for editorial assets. | |
collection_code |
✅ | ✅ | 2- or 3-letter code for the collection in which the asset resides. |
collection_id |
✅ | ✅ | 2- or 3-number code for the collection in which the asset resides. |
collection_name |
✅ | ✅ | Name of the collection in which the asset resides. |
color_type |
✅ | ✅ | Indicates whether the image is color or black and white. Possible values are color , black_and_white , and null. |
comp |
✅ | ✅ | Provides the URL for the comp-sized file. These are 612 px on the longest side. |
copyright |
✅ | ✅ | Copyright line for the asset. |
country |
✅ | Name of the country, if known, in which the asset was created. Typically only relevant for editorial assets. | |
date_camera_shot |
✅ | ✅ | Date from the camera used to take the photo. |
date_created |
✅ | ✅ | Date the asset was shot/created. Relevant for Editorial images, not always relevant for Creative images. This value is provided by the contributor at the time of asset submission. |
date_submitted |
✅ | ✅ | The date the image was submitted by the contributor to the Getty Images catalog. |
detail_set |
✅ | ✅ | A quick way to retrieve the following fields without having to request them individually: id , allowed_use , artist , asset_family , call_for_image , caption , collection_code , collection_id , collection_name , copyright , date_created , display_sizes , editorial_segments , event_ids , graphical_style , license_model , max_dimensions , orientation , product_type , quality_rank , referral_destinations , and title . |
display_set |
✅ | ✅ | A quick way to retrieve the following fields (URLs) without having to request them individually: comp , preview , and thumb |
download_product |
✅ | ✅ | The name of the authenticated user’s product (subscription) under which the image falls: premiumaccess , editorialsubscription , easyaccess , ultrapck |
download_sizes |
✅ | ✅ | List of files available for download from the authenticated user’s product. |
editorial_segments |
✅ | ✅ | Indicates if the editorial asset is news, sport, entertainment, archive, royalty or publicity. Not provided for creative images. |
event_ids |
✅ | ✅ | Provides the IDs for the editorial events to which the asset is associated. These IDs can also be used as query parameters to retrieve all images associated with the event. Not provided for creative assets. |
graphical_style |
✅ | ✅ | Indicates of the image is a photograph or illustration. |
high_res_comp |
✅ | ✅ | Provides the URL for the high res comp file. This restricted field is only available to a small number of applications. |
id |
✅ | ✅ | ID number for the asset. This is a unique value. |
istock_collection |
✅ | ✅ | For images from the iStock catalog, provides the name of the collection the image falls under: essentials, signature. |
keywords |
✅ | ✅ | Provides all keywords for the asset, including keyword text, keyword ID, keyword type and relevance (relevance is not used for creative images). |
largest_downloads |
✅ | ✅ | Provides the URI to download the largest file availlabe for the given asset. This URI is used in download endpoint. |
license_model |
✅ | ✅ | Indicates whether the asset is royalty-free or rights-managed. |
max_dimensions |
✅ | ✅ | Pixel dimensions of the largest file available for the asset. |
mid_res_comp |
✅ | ✅ | Provides the URL for the mid res comp file. This restricted field is only available to a small number of applications. |
object_name |
✅ | Provides the name of the original file submitted by the photographer. May not be availabe for every asset. | |
orientation |
✅ | ✅ | Indicates if the asset is vertical, horizontal, square or panoramic. |
people |
✅ | ✅ | Indicates who is present in the photo. This value is only provided for some editorial images and may not provide the names of all persons in the image. |
preview |
✅ | ✅ | Provides the URL for the preview file. Typically around 590 px on the longest side. |
product_types |
✅ | ✅ | Indicates which product, if any, the asset falls according to the terms of your license agreement. |
quality_rank |
✅ | ✅ | Indicates a value of 0-3 for the quality of the asset. For Editorial assets, rank 0 and 1 means the image is highly representative of the event it’s from. Rank 2 images are representative by not as highly relevant as rank 1. Rank 3 are images are background, filler shots. |
referral_destinations |
✅ | ✅ | Provides the URL for the asset website(s) on which the asset can be found. |
state_province |
✅ | Indicates the state or province, if known, in which the asset was created. Typically only relevant for editorial assets. | |
summary_set |
✅ | ✅ | A quick way to retrieve the following fields without having to request them individually: id , asset_family , caption , collection_code , collection_id , collection_name , display_sizes , license_model , max_dimensions , and title |
thumb |
✅ | ✅ | Provides the URL for the thumbnail file, 170 px on the longest side. |
title |
✅ | ✅ | Provides the title of the asset. |
uri_oembed |
✅ | ✅ | Provides the oEmbed URI for the asset. |