View as Markdown
Getty Images icon

Getty Images TRIGGER

New Search Result

Emit new event for each image returned by a search query that has not been seen in a previous run. Polls on a schedule to detect newly available images matching your criteria. See the documentation
  • Trigger
  • Polling
  • OAuth
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Getty Images account, configure the source, and choose the webhook where your backend receives events.

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 deployed = await pd.triggers.deploy({
  id: "getty_images-new-search-result",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    getty_images: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    phrase: "Search Phrase",
  },
  webhookUrl: "https://example.com/webhooks/getty-images",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New Search Result configuration
Property Type Description
timer Timer $.interface.timer
Required
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
pageSize Page Size integer
Number of results to return per page (1–100). Defaults to 30.
Optional

01

Connect

Your user authorizes Getty Images through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
getty_images-new-search-result
Version
0.0.1
App
Getty Images
Authentication
OAuth
Delivery
Polling source
Output
Events emitted by Getty Images.