Search Stock Images

The "Search Stock Images" step allows you to find and retrieve high-quality stock images from AirOps' integration with stock image providers. You can search for images using keywords and filter results based on your specific needs.

How to Configure the Search Stock Images Step

Configuring the step requires setting the parameters shown below:

[IMAGE: Screenshot of the Search Stock Images step configuration panel]

Search Query

Enter the keywords you want to use to search for relevant stock images. Be specific to get the most relevant results.

You can use Liquid syntax to dynamically reference variables:

{{ step_1.output.image_topic }}

Number of Results

Select the maximum number of stock images to return in the results. This allows you to control how many options you'll have to choose from.

Orientation (Optional)

Choose the orientation of the images you want to find:

• All Orientations

• Horizontal

• Vertical

• Square

Size (Optional)

Select the desired size of the images:

• All Sizes

• Small

• Medium

• Large

License Type (Optional)

Filter images by license type:

• All Licenses

• Free

• Premium

Output Format

The Search Stock Images step returns a JSON array of image results. Each result contains:

[
  {
    "id": "unique-image-id-123",
    "thumbnail_url": "https://example.com/thumbnail.jpg",
    "preview_url": "https://example.com/preview.jpg",
    "download_url": "https://example.com/download.jpg",
    "title": "Business Meeting",
    "description": "Professional team collaborating in modern office",
    "author": "Photographer Name",
    "license_type": "free"
  },
  {
    "id": "unique-image-id-456",
    "thumbnail_url": "https://example.com/thumbnail2.jpg",
    "preview_url": "https://example.com/preview2.jpg",
    "download_url": "https://example.com/download2.jpg",
    "title": "Digital Marketing",
    "description": "Creative team working on marketing strategy",
    "author": "Photographer Name 2",
    "license_type": "premium"
  }
]

[IMAGE: Screenshot showing an example of search results in the AirOps interface]

How to Use the Results

You can access the image URLs in subsequent workflow steps using Liquid syntax. For example:

{{ step_1.output[0].download_url }}

This will reference the download URL of the first image in the results array.

Common Use Cases

• Finding featured images for blog posts

• Sourcing visuals for marketing materials

• Creating social media content

• Adding images to email campaigns

How to Continue if the Search Fails

By default, the Search Stock Images step will terminate the workflow if it fails. To continue the workflow if the step fails, click "Continue" at the bottom of the settings panel.

[IMAGE: Screenshot showing the "Continue" option in the step settings]

The step will return the following keys when it fails:

• output: this will be null

• error:

  • message: the message returned from the step

  • code: the error code representing the error

Example Workflow

A common pattern is to use the Search Stock Images step followed by an LLM step that selects the most appropriate image based on content context:

1. Use Search Stock Images step to find images related to your topic

2. Pass the image results to an LLM step

3. Have the LLM analyze and select the most appropriate image

4. Use the selected image in your final content