Metadata
Use the Media Delivery API to return an asset's metadata instead of the asset itself, narrow the response to the fields you need, and reference metadata values from inside an image query.
Base URL pattern
The parameters on this page are appended to a Dynamic Media image URL. For the URL pattern and how parameters chain together, see the Media Delivery API guide.
metadata=true — Retrieve all metadataLink copied!
Returns all metadata associated with an image. Specify the format by appending the appropriate extension to the URL.
| Extension | Format |
|---|---|
.js | JSONP |
.json | JSON |
.xml | XML |
Example:
metaFilter - Filter metadataLink copied!
Returns only metadata for the specified type. Use metaFilter=* to return all types. The image metadata block is always included.
Example:
Referencing metadata in queriesLink copied!
You can reference an image's metadata directly within transformation queries using the following tokens:
| Token | Description |
|---|---|
{$this.metadata} | Metadata from the current layer. |
{$root.metadata} | Metadata from the root layer. |
{$root.layerX.metadata} | Metadata from the root layer. Where multiple layers exist, this allows you to check the specific layer you want, for example layer2. |
{$parent.metadata} | Metadata from the parent layer. Where multiple layers exist, this will always check for the immediate parent. |
The example below crops using the point of interest stored in the image's own metadata - no hard-coded poi values. Resize the output and the crop keeps following the focal point: