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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "getty_images-search-images",
"configured_props": {
"getty_images": { "authProvisionId": "apn_xxxxxxx" },
"phrase": "Search Phrase",
"imageType": "Image Type"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "getty_images",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "getty_images-search-images",
arguments: {
phrase: "Search Phrase",
imageType: "Image Type",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗