# Getty Images — Pipedream Connect

> News, Fashion, and Entertainment imagery

- API slug: `getty_images` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Infrastructure & Cloud
- Website: https://www.gettyimages.com
- This page (HTML): https://pipedream.com/apps/getty-images
- Tools: 4 actions · 3 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: getty_images`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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()

// e.g. run Create Collection:
const result = await mcp.callTool({
  name: "getty_images-create-collection",
  arguments: {
    collectionName: "Collection Name",
    collectionDescription: "Collection Description",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Getty Images endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.gettyimages.com/v3/products

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZ2V0dHlpbWFnZXMuY29tL3YzL3Byb2R1Y3Rz?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-create-collection",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    getty_images: { authProvisionId: "apn_xxxxxxx" },
    collectionName: "Collection Name",
    collectionDescription: "Collection Description",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (4)

### `getty_images-create-collection` — Create Collection (Write)

Create a new image collection (board) in Getty Images. Provide a name and an optional description. Returns the created collection's ID and metadata. See the documentation

Full schema: https://pipedream.com/apps/getty-images/actions/create-collection.md

### `getty_images-download-image` — Download Image (Write)

Download a licensed Getty Images asset by image ID. Returns a URI valid for up to 24 hours that can be used to download the file. Requires an active product subscription — use the Search Images action with Include Download Sizes enabled to confirm the asset is downloadable under your account. See…

Full schema: https://pipedream.com/apps/getty-images/actions/download-image.md

### `getty_images-list-product-type-options` — List Product Type Options (Read-only)

Retrieves available options for the Product Type field.

Full schema: https://pipedream.com/apps/getty-images/actions/list-product-type-options.md

### `getty_images-search-images` — Search Images (Read-only)

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

Full schema: https://pipedream.com/apps/getty-images/actions/search-images.md

## Triggers (3)

### `getty_images-new-image` — New Board Asset (Polling)

Emit new event each time an asset is added to a Getty Images board. Polls the board's asset list on a schedule. See the documentation

Full schema: https://pipedream.com/apps/getty-images/triggers/new-image.md

### `getty_images-new-download` — New Download (Polling)

Emit new event each time an image is downloaded from the Getty Images account. Polls the download history on a schedule. See the documentation

Full schema: https://pipedream.com/apps/getty-images/triggers/new-download.md

### `getty_images-new-search-result` — New Search Result (Polling)

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

Full schema: https://pipedream.com/apps/getty-images/triggers/new-search-result.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt