Cloudinary icon

Cloudinary

Upload to Cloudinary

Actions5

Overview

This node integrates with the Cloudinary service to manage media assets and metadata. Specifically, the Admin - Get Tags operation retrieves tags associated with a specified type of resource (image, video, or raw files) stored in Cloudinary. This is useful for organizing, filtering, or analyzing media assets based on their tags.

Common scenarios include:

  • Fetching all tags for images to display tag options in a UI.
  • Retrieving video tags to filter or categorize video content.
  • Getting raw file tags for asset management or reporting.

Practical example: A marketing team wants to list all tags used for images in their Cloudinary account to create a tag-based navigation system on their website. Using this node, they can fetch those tags dynamically.

Properties

Name Meaning
Resource Type The type of resource to get tags for. Options: Image, Video, Raw.
Prefix Filter tags that start with this prefix (optional).
Max Results Maximum number of tags to return, between 1 and 500. Defaults to 100.

Output

The output is a JSON object containing the tags retrieved from Cloudinary for the specified resource type. The structure typically includes an array of tag names and possibly additional metadata about each tag as returned by the Cloudinary API.

Example output snippet (simplified):

{
  "tags": [
    "tag1",
    "tag2",
    "exampleTag"
  ]
}

No binary data is output by this operation.

Dependencies

  • Requires a valid Cloudinary account with API credentials (cloud name, API key, and API secret).
  • The node uses these credentials to authenticate requests to the Cloudinary REST API.
  • No additional external dependencies beyond the Cloudinary API and n8n's HTTP request helper.

Troubleshooting

  • Invalid Credentials Error: If authentication fails, verify that the API key, secret, and cloud name are correctly configured in the node credentials.
  • Empty Tag List: If no tags are returned, check if the resource type is correct and if any tags exist in the Cloudinary account for that resource.
  • Prefix Filtering Issues: Ensure the prefix string is correctly set; an incorrect prefix may result in zero tags returned.
  • Max Results Limits: Setting Max Results outside the allowed range (1-500) may cause errors or unexpected behavior.

Links and References

Discussion