Cloudinary icon

Cloudinary

Upload images and videos, build optimized transformation and delivery URLs, generate video players, and manage, search, tag, and edit metadata in your Cloudinary media library

Actions23

Asset → Search Assets

AI-generated

Overview

This node operation allows users to search for assets in their Cloudinary media library using a flexible search expression. It supports filtering by resource types such as images, videos, and raw files, and can return all matching assets with automatic pagination or a limited number of results. Users can also specify sorting options and include additional fields like tags and contextual metadata in the search results. This is useful for managing and retrieving specific media assets based on complex criteria, such as tags, upload dates, or folder paths.

Use Case Examples

  1. Search for all images tagged with 'cat' uploaded in the last day.
  2. Retrieve all video assets in a specific folder sorted by upload date.
  3. Fetch assets with specific tags and include their contextual metadata for further processing.

Properties

Name Meaning
Expression Cloudinary search expression to filter assets, e.g., tags, folder paths, or upload dates. Leave empty to match all assets.
Resource Types Types of resources to include in the search, such as images, videos, or raw files. Ignored if the expression already specifies resource types.
Return All Whether to return all matching assets by automatically paginating through results.
Max Results Maximum number of assets to return when not returning all. Range is 1 to 500.
Additional Fields Optional parameters to control pagination cursor, sorting field and direction, and extra attributes to include such as tags or context metadata.

Output

JSON

  • public_id - Unique identifier of the asset.
  • resource_type - Type of the asset resource, e.g., image, video, raw.
  • type - Delivery type of the asset.
  • format - File format of the asset.
  • created_at - Timestamp when the asset was created.
  • tags - List of tags associated with the asset, if requested.
  • context - Contextual metadata key-value pairs associated with the asset, if requested.
  • next_cursor - Cursor for pagination to fetch the next set of results, if available.

Dependencies

  • Cloudinary API credentials including cloud name, API key, and API secret

Troubleshooting

  • Unsupported operation error if the specified resource or operation is not implemented in the node.
  • Errors related to invalid search expressions or API authentication failures.
  • Pagination issues if the next cursor is invalid or expired.

Links

Discussion