View as Markdown
Getty Images icon

Getty Images ACTION

Search Images

Search the Getty Images library by keyword with optional filters for image type, orientation, and license model. Returns image metadata including IDs, titles, captions, and display URLs. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Getty Images account once, then configure and run Search Images from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "getty_images-search-images",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    getty_images: { authProvisionId: "apn_xxxxxxx" },
    phrase: "Search Phrase",
    imageType: "Image Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Images inputs
Property Type Description
phrase Search Phrase string
Keywords or a phrase to search for, e.g. golden gate bridge or business team meeting.
Required
imageType Image Type string
Scope the search to creative, editorial, or all images. Creative images are royalty-free or rights-managed stock; editorial covers news, sports, and entertainment.
Optional
orientation Orientation string
Filter results by image orientation.
Optional
licenseModel License Model string
Filter creative images by license type. Only applies when Image Type is set to creative — ignored for editorial or general searches.
Optional
sortOrder Sort Order string
Order in which to return search results.
Optional
pageSize Page Size integer
Number of results to return per page (1–100). Defaults to 30.
Optional
includeDownloadSizes Include Download Sizes boolean
Include largest_downloads in each result. Required to obtain product types for the Download Image action. Requires a valid OAuth access token with download permissions.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
getty_images-search-images
Version
0.0.2
App
Getty Images
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes