Getty Images
Getty Images endpoints from Gettyimages
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Getty Images endpoints from Gettyimages
Endpoints 52
AffiliateSearch
- GETGET /v3/affiliates/search/images
/v3/affiliates/search/images?phrase=string&style=photography - GETGET /v3/affiliates/search/videos
/v3/affiliates/search/videos?phrase=string
Artists
- GETSearch for images by a photographer
/v3/artists/images?artist_name=string&fields=id&page=1&page_size=10 - GETSearch for videos by a photographer
/v3/artists/videos?artist_name=string&fields=id&page=1&page_size=10
AssetChanges
- PUTGet asset change notifications.
/v3/asset-changes/change-sets?channel_id=0&batch_size=0Asset Changes Get notifications about new, updated or deleted assets for a specific channel. Quickstart You'll need an API key and an access token to use this… - DELETEConfirm asset change notifications.
/v3/asset-changes/change-sets/:change-set-idDelete Asset Changes Confirm asset changes acknowledges receipt of asset changes (from the PUT asset-changes endpoint). Quickstart You'll need an API key and… - GETGet a list of asset change notification channels.
/v3/asset-changes/channelsGet Partner Channels Retrieves the channel data for the partner. This data can be used to populate the channel_id parameter in the Put Asset Changes query.…
AssetLicensing
- POSTEndpoint for acquiring extended licenses with iStock credits for an asset.
/v3/asset-licensing/:assetId
AssetManagement
- GETGET /v3/asset-management/assets/send-events
/v3/asset-management/assets/send-events?last_offset=2024-01-01T00:00:00Z&event_count=0
Boards
- GETGet all boards that the user participates in
/v3/boards?page=1&board_relationship=owned&sort_order=date_last_updated_descending&pageSize=30 - POSTCreate a new board
/v3/boards - GETGet assets and metadata for a specific board
/v3/boards/:board_id - PUTUpdate a board
/v3/boards/:board_id - DELETEDelete a board
/v3/boards/:board_id - PUTAdd assets to a board
/v3/boards/:board_id/assets - DELETERemove assets from a board
/v3/boards/:board_id/assets?asset_ids=string - PUTAdd an asset to a board
/v3/boards/:board_id/assets/:asset_id - DELETERemove an asset from a board
/v3/boards/:board_id/assets/:asset_id - GETGet comments from a board
/v3/boards/:board_id/comments - POSTAdd a comment to a board
/v3/boards/:board_id/comments - DELETEDelete a comment from a board
/v3/boards/:board_id/comments/:comment_id
Collections
- GETGets collections applicable for the customer.
/v3/collectionsUse this endpoint to retrieve collections associated with your Getty Images account. To browse available collections see our [Image collections page](…
Countries
- GETGets countries codes and names.
/v3/countriesReturns a list of country objects that contains country name, two letter ISO abbreviation and three letter ISO abbreviation. You'll need an API key and access…
Customers
- GETReturns information about the current user.
/v3/customers/currentReturns the first, middle and last name of the authenticated user. You'll need an API key and access token to use this resource. Please consult our…
Downloads
- GETReturns information about a customer's downloaded assets.
/v3/downloads?date_from=2024-01-01T00:00:00Z&date_to=2024-01-01T00:00:00Z&use_time=false&page=1&page_size=30&product_type=easyaccess&company_downloads=falseReturns information about a customer's previously downloaded assets. You'll need an API key and access token to use this resource. This endpoint requires… - POSTDownload an image
/v3/downloads/images/:id?auto_download=true&file_type=eps&height=string&product_id=0&product_type=easyaccess&use_team_credits=falseUse this endpoint to generate download URLs and related data for images you are authorized to download. Most product offerings have enforced periodic download… - POSTDownload a video
/v3/downloads/videos/:id?auto_download=false&size=string&product_id=0&product_type=easyaccess&use_team_credits=trueUse this endpoint to generate download URLs and related data for videos you are authorized to download. Most product offerings have enforced periodic download…
Events
- GETGet metadata for multiple events
/v3/events?ids=0&fields=idThis endpoint returns the detailed event metadata for all specified events. Getty Images news, sports and entertainment photographers and videographers cover… - GETGet metadata for a single event
/v3/events/:id?fields=idThis endpoint returns the detailed event metadata for a specified event. Getty Images news, sports and entertainment photographers and videographers cover…
Images
- GETGet metadata for multiple images by supplying multiple image ids
/v3/images?ids=string&fields=allowed_useThis endpoint returns the detailed image metadata for all specified images. You'll need an API key and access token to use this resource. Working with Fields… - GETGet metadata for a single image by supplying one image id
/v3/images/:id?fields=allowed_useThis endpoint returns the detailed image metadata for a specified image. You'll need an API key and access token to use this resource. Working with Fields… - GETReturns information about a customer's download history for a specific asset
/v3/images/:id/downloadhistory?company_downloads=true - GETRetrieve creative images from the same series
/v3/images/:id/same-series?fields=accessrestriction&page=1&page_size=30This endpoint will provide the list of images, if any exist, from the same series as the specified creative asset id. These images are typically from the same… - GETRetrieve similar images
/v3/images/:id/similar?fields=accessrestriction&page=1&page_size=30This endpoint will provide a list of images that are similar to the specified asset id. You'll need an API key and access token to use this resource. Working…
Orders
- GETGet order metadata
/v3/orders/:idThis endpoint returns detailed order metadata for a specified order. Use of this endpoint requires configuration changes to your API key. You'll need an API…
Products
- GETGet Products
/v3/products?fields=download_requirementsThis endpoint returns all products available to the username used during authentication. As such, this endpoint requires the use of a fully authorized…
Purchases
- GETGet Previously Purchased Images and Video
/v3/purchased-assets?date_to=2024-01-01T00:00:00Z&page=1&page_size=75&date_from=2024-01-01T00:00:00Z&company_purchases=falseThis endpoint returns a list of all assets purchased on gettyimages.com by the username used for authentication. Use of this endpoint requires configuration…
Search
- PUTUpload image for use by the search creative images/videos operations
/v3/search/by-image/uploads/:file-name - GETSearch for events
/v3/search/events?editorial_segment=archival&date_from=2024-01-01T00:00:00Z&date_to=2024-01-01T00:00:00Z&fields=id&page=1&page_size=30&phrase=&sort_order=newestUse this endpoint to search Getty Images news, sports and entertainment events. Getty Images photographers and videographers cover editorially relevant events… - GETSearch for both creative and editorial images - *** DEPRECATED ***
/v3/search/images?age_of_people=newborn&artists=string&collection_codes=string&collections_filter_type=include&color=string&compositions=abstract&download_product=string&embed_content_only=false&event_ids=0ðnicity=black&exclude_nudity=false&fields=accessrestriction&file_types=eps&graphical_styles=fine_art&graphical_styles_filter_type=include&include_related_searches=false&keyword_ids=0&minimum_size=x_small&number_of_people=none&orientations=horizontal&page=1&page_size=30&phrase=string&sort_order=best_match&specific_people=string_This endpoint draws from such a large diversity of content, the results will not be as relevant as when the more specific Creative or Editorial endpoints are… - GETSearch for creative images only
/v3/search/images/creative?age_of_people=newborn&artists=string&collection_codes=string&collections_filter_type=include&color=string&compositions=abstract&download_product=string&embed_content_only=falseðnicity=black&exclude_keyword_ids=0&exclude_nudity=false&exclude_editorial_use_only=true&fields=allowed_use&file_types=eps&graphical_styles=fine_art&graphical_styles_filter_type=include&include_related_searches=false&keyword_ids=0&minimum_size=x_small&number_of_people=none&orientations=horizontal&page=1&page_size=30&phrase=&safe_search=false&sort_order=best_match&facet_fields=artists&include_facets=true&facet_max_count=300Use this endpoint to search our contemporary stock photos, illustrations and archival images. You'll need an API key and access token to use this resource.… - GETSearch for creative images based on url
/v3/search/images/creative/by-image?asset_id=string&exclude_editorial_use_only=true&facet_fields=artists&facet_max_count=300&fields=allowed_use&image_url=string&include_facets=true&page=1&page_size=30&product_types=stringSearch for similar creative images by passing an image_url to an uploaded image OR an asset_id of an asset in our catalog. All responses will have the… - GETSearch for editorial images only
/v3/search/images/editorial?age_of_people=newborn&artists=string&collection_codes=string&collections_filter_type=include&compositions=abstract&date_from=2024-01-01T00:00:00Z&date_to=2024-01-01T00:00:00Z&download_product=string&editorial_segments=archival&embed_content_only=falseðnicity=black&event_ids=0&exclude_keyword_ids=0&fields=allowed_use&file_types=eps&graphical_styles=photography&graphical_styles_filter_type=include&include_related_searches=false&keyword_ids=0&minimum_size=x_small&number_of_people=none&orientations=horizontal&page=1&page_size=30&phrase=string&sort_order=best_match&specific_people=string&minimum_quality_rank=0&facet_fields=artists&include_facets=true&facet_max_count=300Use this endpoint to search our editorial stock photos, illustrations and archival images. Editorial images represent newsworthy events or illustrate matters… - GETSearch for creative videos
/v3/search/videos/creative?age_of_people=newborn&artists=string&aspect_ratios=16:9&collection_codes=string&collections_filter_type=include&compositions=abstract&download_product=string&exclude_nudity=false&exclude_editorial_use_only=true&exclude_keyword_ids=0&fields=allowed_use&format_available=sd&frame_rates=23.98&image_techniques=realtime&include_related_searches=false&keyword_ids=0&license_models=rightsready&orientations=horizontal&min_clip_length=0&max_clip_length=0&page=1&page_size=30&phrase=&safe_search=false&sort_order=best_match&release_status=release_not_important&facet_fields=artists&facet_max_count=300&include_facets=true&viewpoints=lockdownUse 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… - GETSearch for creative videos based on url
/v3/search/videos/creative/by-image?asset_id=string&exclude_editorial_use_only=true&facet_fields=artists&facet_max_count=300&fields=allowed_use&image_url=string&include_facets=true&page=1&page_size=30&product_types=stringSearch for similar creative videos by passing an image_url to an uploaded image/frame grab from a video OR an asset_id of an asset in our catalog. All… - GETSearch for editorial videos
/v3/search/videos/editorial?age_of_people=newborn&artists=string&aspect_ratios=16:9&collection_codes=string&collections_filter_type=include&compositions=abstract&download_product=string&editorial_video_types=raw&fields=allowed_use&format_available=sd&frame_rates=23.98&image_techniques=realtime&include_related_searches=false&keyword_ids=0&min_clip_length=0&max_clip_length=0&orientations=horizontal&page=1&page_size=30&phrase=&sort_order=best_match&specific_people=string&release_status=release_not_important&facet_fields=artists&include_facets=true&facet_max_count=300&viewpoints=lockdownUse this endpoint to search current and archival video clips of celebrities, newsmakers, and events. You'll need an API key and access token to use this…
Usage
- PUTReport usage of assets via a batch format.
/v3/usage-batches/:idReport Usage Use this endpoint to report the usages of a set of assets. The count of assets submitted in a single batch to this endpoint is limited to 1000.…
Videos
- GETGet metadata for multiple videos by supplying multiple video ids
/v3/videos?ids=string&fields=idUse this endpoint to return detailed video metadata for all the specified video ids. You'll need an API key and access token to use this resource. You can… - GETGet metadata for a single video by supplying one video id
/v3/videos/:id?fields=idUse this endpoint to return detailed video metadata for the specified video id. You'll need an API key and access token to use this resource. You can show… - GETReturns information about a customer's download history for a specific asset
/v3/videos/:id/downloadhistory?company_downloads=true - GETRetrieve creative videos from the same series
/v3/videos/:id/same-series?fields=allowed_use&page=1&page_size=30This endpoint will provide the list of videos, if any exist, from the same series as the specified creative asset id. These images are typically from the same… - GETRetrieve similar videos
/v3/videos/:id/similar?fields=allowed_use&page=1&page_size=30This 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…
API details
- Authentication
- An API key in the Api-Key header
OAuth 2.0 (authorization code, client credentials, implicit, password flows) - Operations
- 52 operations on 46 pathsGET 36PUT 6POST 5DELETE 5
- Main resources
- Boards 12Search 9Images 5Videos 5AssetChanges 3Downloads 3AffiliateSearch 2Artists 2Events 2AssetLicensing 1
- Response formats
application/jsontext/jsontext/plain- Description format
- OpenAPI 3.0.1, API version
3 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Getty Images in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Getty Images collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the Api-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /v3/affiliates/search/images” (GET /v3/affiliates/search/images?phrase=string&style=photography), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Getty Images?
Getty Images endpoints from Gettyimages It is listed under Media & content and has 52 endpoints.
Who publishes the Getty Images?
It is listed from Gettyimages's public API description (an OpenAPI document), not published by Gettyimages on Swastik Codes. Anyone who controls gettyimages.com can claim the profile by adding a DNS TXT record.
How do I authenticate with the Getty Images?
It accepts 2 methods: an API key in the Api-Key header; OAuth 2.0 (authorization code, client credentials, implicit, password flows).
How many endpoints does the Getty Images have?
52 operations on 46 paths (36 GET, 6 PUT, 5 POST, 5 DELETE). The largest groups are Boards, Search, Images, Videos.
Is forking the Getty Images free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.