# Adobe Stock

> Search Adobe Stock's photos, illustrations, vectors, videos and templates, find related files and read file details.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/adobe-stock

## Actions

### Find files like an image

Find Adobe Stock files that look like an image on the web.

**Inputs**

- Image URL (`image_url`, text, required): Web address of an image, starting with `https://`.
- Content types (`content_types`, list): Kinds of file to include. Leave empty for every kind. One or more of: `photo` (Photos), `illustration` (Illustrations), `vector` (Vectors), `video` (Videos), `template` (Templates), `3d`.
- Orientation (`orientation`, text): Shape of the files to include. Leave empty for any shape. One of: `horizontal` (Landscape), `vertical` (Portrait), `square`.
- Premium files (`premium`, text): Whether to include Premium files, which cost more to license. One of: `all` (Standard and Premium), `standard` (Standard only), `premium` (Premium only). Default: `all`.
- AI-generated files (`ai_generated`, text): Whether to include files made with generative AI. Leave empty to include them. One of: `include`, `only` (Only AI-generated), `exclude`.
- Only files with releases (`with_releases_only`, true/false): Only files whose people or property have a signed release, for commercial use.
- Only isolated subjects (`isolated_only`, true/false): Only files with the subject cut out on a plain background.
- Only transparent backgrounds (`transparent_only`, true/false): Only files with a transparent background.
- Limit (`limit`, number): How many files to return, from 1 to 100. Leave empty for 32. From 1 to 100.
- Offset (`offset`, number): How many files to skip, to read the next page of results. Leave empty to start at the first. At least 0.
- Language (`language`, text): Language for titles, keywords and category names. Leave empty for English (United States). One of: `en_US` (English (United States)), `en_UK` (English (United Kingdom)), `en_AU` (English (Australia)), `ca_EN` (English (Canada)), `fr_CA` (French (Canada)), `fr_FR` (French (France)), `de_DE` (German), `es_ES` (Spanish (Spain)), `es_MX` (Spanish (Mexico)), `it_IT` (Italian), and 12 more.

**Outputs**

- `data` (object): The response from Adobe Stock.

**Example output**

```json
{
  "data": {
    "files": [
      {
        "category": {
          "id": 1,
          "name": "example"
        },
        "comp_url": "example",
        "content_type": "example",
        "creator_id": 1,
        "creator_name": "example",
        "details_url": "example",
        "duration": 1,
        "has_releases": true,
        "height": 1,
        "id": 1,
        "is_gentech": true,
        "is_premium": true,
        "keywords": [
          {}
        ],
        "media_type_id": 1,
        "premium_level_id": 1,
        "thumbnail_url": "example",
        "title": "example",
        "video_preview_url": "example",
        "width": 1
      }
    ],
    "nb_results": 1
  }
}
```

### Find related files

Find Adobe Stock files that look like a file, or come from the same photo series or model as it.

**Inputs**

- File ID (`file_id`, number, required): The Adobe Stock file to compare with, from an earlier search result.
- Find files that (`match`, text): What the files have in common with the file. Leave empty for files that look similar. One of: `looks_similar` (Looks similar), `same_series` (Same photo series), `same_model` (Same model).
- Content types (`content_types`, list): Kinds of file to include. Leave empty for every kind. One or more of: `photo` (Photos), `illustration` (Illustrations), `vector` (Vectors), `video` (Videos), `template` (Templates), `3d`.
- Orientation (`orientation`, text): Shape of the files to include. Leave empty for any shape. One of: `horizontal` (Landscape), `vertical` (Portrait), `square`.
- Premium files (`premium`, text): Whether to include Premium files, which cost more to license. One of: `all` (Standard and Premium), `standard` (Standard only), `premium` (Premium only). Default: `all`.
- AI-generated files (`ai_generated`, text): Whether to include files made with generative AI. Leave empty to include them. One of: `include`, `only` (Only AI-generated), `exclude`.
- Only files with releases (`with_releases_only`, true/false): Only files whose people or property have a signed release, for commercial use.
- Only isolated subjects (`isolated_only`, true/false): Only files with the subject cut out on a plain background.
- Only transparent backgrounds (`transparent_only`, true/false): Only files with a transparent background.
- Limit (`limit`, number): How many files to return, from 1 to 100. Leave empty for 32. From 1 to 100.
- Offset (`offset`, number): How many files to skip, to read the next page of results. Leave empty to start at the first. At least 0.
- Language (`language`, text): Language for titles, keywords and category names. Leave empty for English (United States). One of: `en_US` (English (United States)), `en_UK` (English (United Kingdom)), `en_AU` (English (Australia)), `ca_EN` (English (Canada)), `fr_CA` (French (Canada)), `fr_FR` (French (France)), `de_DE` (German), `es_ES` (Spanish (Spain)), `es_MX` (Spanish (Mexico)), `it_IT` (Italian), and 12 more.

**Outputs**

- `data` (object): The response from Adobe Stock.

**Example output**

```json
{
  "data": {
    "files": [
      {
        "category": {
          "id": 1,
          "name": "example"
        },
        "comp_url": "example",
        "content_type": "example",
        "creator_id": 1,
        "creator_name": "example",
        "details_url": "example",
        "duration": 1,
        "has_releases": true,
        "height": 1,
        "id": 1,
        "is_gentech": true,
        "is_premium": true,
        "keywords": [
          {}
        ],
        "media_type_id": 1,
        "premium_level_id": 1,
        "thumbnail_url": "example",
        "title": "example",
        "video_preview_url": "example",
        "width": 1
      }
    ],
    "nb_results": 1
  }
}
```

### Get files

Get the details of up to 110 Adobe Stock files by their IDs: title, size, creator, category, keywords and preview links.

**Inputs**

- File IDs (`file_ids`, list, required): IDs of the Adobe Stock files, from search results or the number in a file's page address.
- Language (`language`, text): Language for titles, keywords and category names. Leave empty for English (United States). One of: `en_US` (English (United States)), `en_UK` (English (United Kingdom)), `en_AU` (English (Australia)), `ca_EN` (English (Canada)), `fr_CA` (French (Canada)), `fr_FR` (French (France)), `de_DE` (German), `es_ES` (Spanish (Spain)), `es_MX` (Spanish (Mexico)), `it_IT` (Italian), and 12 more.

**Outputs**

- `data` (object): The response from Adobe Stock.

**Example output**

```json
{
  "data": {
    "files": [
      {
        "category": {
          "id": 1,
          "name": "example"
        },
        "comp_url": "example",
        "content_type": "example",
        "creator_id": 1,
        "creator_name": "example",
        "details_url": "example",
        "duration": 1,
        "has_releases": true,
        "height": 1,
        "id": 1,
        "is_gentech": true,
        "is_premium": true,
        "keywords": [
          {}
        ],
        "media_type_id": 1,
        "premium_level_id": 1,
        "thumbnail_url": "example",
        "title": "example",
        "video_preview_url": "example",
        "width": 1
      }
    ],
    "nb_results": 1
  }
}
```

### List categories

List Adobe Stock's top-level categories, or the subcategories of one category.

**Inputs**

- Parent category (`category_id`, text): List the subcategories of this category. Leave empty for the top-level categories.
- Language (`language`, text): Language for titles, keywords and category names. Leave empty for English (United States). One of: `en_US` (English (United States)), `en_UK` (English (United Kingdom)), `en_AU` (English (Australia)), `ca_EN` (English (Canada)), `fr_CA` (French (Canada)), `fr_FR` (French (France)), `de_DE` (German), `es_ES` (Spanish (Spain)), `es_MX` (Spanish (Mexico)), `it_IT` (Italian), and 12 more.

**Outputs**

- `data` (list): The response from Adobe Stock.

**Example output**

```json
{
  "data": [
    {
      "id": 1,
      "link": "example",
      "name": "example"
    }
  ]
}
```

### Search files

Search Adobe Stock for photos, illustrations, vectors, videos, templates and 3D files by keyword, category or creator.

**Inputs**

- Keywords (`keywords`, text): Words describing what you're looking for, such as `dog on a beach`.
- Category (`category_id`, text): Only files in this category.
- Creator ID (`creator_id`, number): Only files by this contributor. Use the creator ID from an earlier search result.
- Content types (`content_types`, list): Kinds of file to include. Leave empty for every kind. One or more of: `photo` (Photos), `illustration` (Illustrations), `vector` (Vectors), `video` (Videos), `template` (Templates), `3d`.
- Orientation (`orientation`, text): Shape of the files to include. Leave empty for any shape. One of: `horizontal` (Landscape), `vertical` (Portrait), `square`.
- Premium files (`premium`, text): Whether to include Premium files, which cost more to license. One of: `all` (Standard and Premium), `standard` (Standard only), `premium` (Premium only). Default: `all`.
- AI-generated files (`ai_generated`, text): Whether to include files made with generative AI. Leave empty to include them. One of: `include`, `only` (Only AI-generated), `exclude`.
- Only files with releases (`with_releases_only`, true/false): Only files whose people or property have a signed release, for commercial use.
- Only isolated subjects (`isolated_only`, true/false): Only files with the subject cut out on a plain background.
- Only transparent backgrounds (`transparent_only`, true/false): Only files with a transparent background.
- Sort by (`order`, text): How to sort the results. Leave empty for the most relevant first. One of: `relevance` (Most relevant), `newest`, `featured`, `most_downloaded` (Most downloaded), `undiscovered`.
- Limit (`limit`, number): How many files to return, from 1 to 100. Leave empty for 32. From 1 to 100.
- Offset (`offset`, number): How many files to skip, to read the next page of results. Leave empty to start at the first. At least 0.
- Language (`language`, text): Language for titles, keywords and category names. Leave empty for English (United States). One of: `en_US` (English (United States)), `en_UK` (English (United Kingdom)), `en_AU` (English (Australia)), `ca_EN` (English (Canada)), `fr_CA` (French (Canada)), `fr_FR` (French (France)), `de_DE` (German), `es_ES` (Spanish (Spain)), `es_MX` (Spanish (Mexico)), `it_IT` (Italian), and 12 more.

**Outputs**

- `data` (object): The response from Adobe Stock.

**Example output**

```json
{
  "data": {
    "files": [
      {
        "category": {
          "id": 1,
          "name": "example"
        },
        "comp_url": "example",
        "content_type": "example",
        "creator_id": 1,
        "creator_name": "example",
        "details_url": "example",
        "duration": 1,
        "has_releases": true,
        "height": 1,
        "id": 1,
        "is_gentech": true,
        "is_premium": true,
        "keywords": [
          {}
        ],
        "media_type_id": 1,
        "premium_level_id": 1,
        "thumbnail_url": "example",
        "title": "example",
        "video_preview_url": "example",
        "width": 1
      }
    ],
    "nb_results": 1
  }
}
```
