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 → Get Asset

AI-generated

Overview

This node operation retrieves detailed information about a specific asset from the Cloudinary media library using its immutable asset ID. It supports optional parameters to include additional data such as accessibility analysis, predominant colors, coordinates (including faces and custom crop regions), image metadata (IPTC, XMP, EXIF), number of pages for multi-page assets, and perceptual hash (pHash). This operation is useful for users who need to fetch comprehensive metadata and analysis results for media assets stored in Cloudinary, enabling enhanced media management and processing workflows.

Use Case Examples

  1. A user wants to get detailed metadata and analysis for an image asset, including detected faces and color information, to use in a digital asset management system.
  2. A workflow requires fetching the number of pages and image metadata of a multi-page PDF asset for automated document processing.

Properties

Name Meaning
Asset ID The immutable asset_id of the asset to retrieve, required for identifying the specific asset.
Options Optional parameters to include additional data in the response such as accessibility analysis, colors, coordinates, faces, image metadata, pages, and perceptual hash.

Output

JSON

  • asset_id - The unique identifier of the asset.
  • public_id - The public identifier of the asset in Cloudinary.
  • format - The file format of the asset.
  • version - The version number of the asset.
  • resource_type - The type of resource (e.g., image, video).
  • type - The delivery type of the asset.
  • created_at - Timestamp when the asset was created.
  • bytes - The size of the asset in bytes.
  • width - Width of the asset in pixels.
  • height - Height of the asset in pixels.
  • url - The URL to access the asset.
  • secure_url - The secure HTTPS URL to access the asset.
  • accessibility_analysis - Accessibility analysis data if requested.
  • colors - Predominant colors and color histogram if requested.
  • coordinates - Coordinates data including faces and custom crop regions if requested.
  • image_metadata - IPTC, XMP, and EXIF metadata if requested.
  • pages - Number of pages for multi-page assets if requested.
  • phash - Perceptual hash of the asset if requested.

Dependencies

  • Cloudinary API credentials (cloud name, API key, API secret)

Troubleshooting

  • Common issues include providing an invalid or non-existent asset ID, which results in an error indicating the asset could not be found.
  • Incorrect or missing Cloudinary API credentials will cause authentication failures.
  • If optional parameters are incorrectly formatted or unsupported, the response may not include the requested additional data.
  • Network connectivity issues can prevent successful API calls to Cloudinary.

Links

Discussion