Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Getty Images Image Match API
version: '3'
security:
- Api-Key: []
- OAuth2: []
tags:
- name: ImageMatch
paths:
/v3/image-match/search:
get:
tags:
- ImageMatch
summary: Searches for image matches using the provided URL
description: 'Search for a single matching image in the Getty Images catalog.
Image Match is used to determine if a source image also exists in the Getty Images catalog.
Access to this functionality is restricted. Please contact your Getty Images account rep for more information.'
parameters:
- name: url
in: query
description: The URL of the image to search for.
required: true
schema:
type: string
responses:
'404':
description: Not Found
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: InvalidImageUrl
operationId: getV3ImageMatchSearch
x-operation-id-source: derived
components:
schemas:
SearchResponse:
type: object
properties:
id:
type:
- string
- 'null'
additionalProperties: false
description: Response model for image search operations
securitySchemes:
Api-Key:
type: apiKey
name: Api-Key
in: header
OAuth2:
type: oauth2
flows:
password:
tokenUrl: https://authentication.gettyimages.com/oauth2/token
refreshUrl: https://authentication.gettyimages.com/oauth2/token
scopes: {}
clientCredentials:
tokenUrl: https://authentication.gettyimages.com/oauth2/token
scopes: {}
authorizationCode:
authorizationUrl: https://authentication.gettyimages.com/oauth2/auth
tokenUrl: https://authentication.gettyimages.com/oauth2/token
refreshUrl: https://authentication.gettyimages.com/oauth2/token
scopes: {}
x-provenance:
method: harvested
publisher: Getty Images
source: https://api.gettyimages.com/swagger/v3/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)