# Shutterstock

> Search Shutterstock's stock photo and video library and pull image details into your workflows.

App · Images & Design · 3 actions. Web page: https://docs.lodol.com/docs/integrations/shutterstock

## Actions

### Get image

Fetch details for a single Shutterstock image.

**Inputs**

- Image ID (`image_id`, text, required): The Shutterstock image ID, as returned by Search images.

**Outputs**

- `contributor_id` (text): ID of the contributor who submitted the image
- `description` (text): Image caption
- `id` (text): Shutterstock image ID
- `image_type` (text): Kind of image, for example 'photo', 'vector', or 'illustration'
- `preview_url` (text): Watermarked preview image URL, safe to show before licensing

**Example output**

```json
{
  "contributor_id": "204183762",
  "description": "Sunrise over a mountain range",
  "id": "1692837465",
  "image_type": "photo",
  "preview_url": "https://image.shutterstock.com/display_pic_with_logo/preview.jpg"
}
```

### Search images

Search Shutterstock's stock image library.

**Inputs**

- Search terms (`query`, text, required): What to search for, for example 'mountain sunrise'.
- Results per page (`per_page`, number): How many images to return (1-100). From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results to return, starting at 1. At least 1. Default: `1`.
- Orientation (`orientation`, text): Optional. Only return images in this shape. One of: `horizontal`, `vertical`.
- Sort by (`sort`, text): Optional. How to order the results. One of: `relevance`, `popular` (Most popular), `newest`, `random`.

**Outputs**

- `images` (list): Images on the requested page
- `total_count` (number): Total images matching the search

**Example output**

```json
{
  "images": [
    {
      "contributor_id": "204183762",
      "description": "Sunrise over a mountain range",
      "id": "1692837465",
      "image_type": "photo",
      "preview_url": "https://image.shutterstock.com/display_pic_with_logo/preview.jpg"
    }
  ],
  "total_count": 48213
}
```

### Search videos

Search Shutterstock's stock video library.

**Inputs**

- Search terms (`query`, text, required): What to search for, for example 'city timelapse'.
- Results per page (`per_page`, number): How many videos to return (1-100). From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results to return, starting at 1. At least 1. Default: `1`.

**Outputs**

- `total_count` (number): Total videos matching the search
- `videos` (list): Videos on the requested page

**Example output**

```json
{
  "total_count": 3921,
  "videos": [
    {
      "contributor_id": "204183762",
      "description": "Timelapse of city traffic at night",
      "duration": 14.5,
      "id": "1098374652",
      "preview_url": "https://ak.picdn.net/shutterstock/videos/preview.mp4"
    }
  ]
}
```