Executes a full-text, visual, and/or filtered search over DAM assets and returns matching assets with the requested fields, taxonomies, relations, and renditions.
Use filterable keys and operators that can be discovered with the DAM Context API. For taxonomy and relation filters, use entity identifier strings, not numeric IDs or labels. In include, use exact key names in their matching section, such as taxonomies or relations, and * is not valid.
The DAM Context API lists the accepted keys for each section. Request taxonomy values through include.taxonomies. Use taxonomy filters to select assets by membership. total counts all matches, while items contains the page selected by skip and take.
Taxonomy filters can match values that are not listed in the expanded taxonomy entry. Use an anyOf relation filter to find assets linked to any of the supplied entity identifiers. Full-text search is not an exact tag-membership test; use the tag taxonomy key to filter for tagged assets.
Use usageRights for a permitted-use scenario, with dates in YYYY-MM-DD. Constraints are ANDed within the same combined rights profile; anyOf requires at least one listed value, not every value. Omitted constraints are unchecked. Check capabilities.usageRights and the advertised keys using the DAM Context API before requesting it.
thumbnailUrl is always returned when the asset has a thumbnail. renditions contains only the rendition keys listed in include.renditions; list thumbnail there to also receive it under renditions. Search returns rendition URLs; dimensions and file size are returned only by asset detail.
The DAM asset search request payload.
Inclusion criteria; results must match these filter conditions. Entries are ANDed together; values within each entry follow the selected operator.
Exclusion criteria; results matching these conditions are filtered out. Supported operators are anyOf, exists, greaterThan, and lessThan; allOf and between are not supported in exclusions.
Optional permitted-use scenario, ANDed with ordinary filters and exclusions. Unrestricted assets qualify; restricted assets require no explicit approval and one combined profile covering the dates and supplied constraints. Omitted dimensions are unchecked; {} checks today's date only, and omitting usageRights performs no rights check. No administrator bypass or download authorization. Requires capabilities.usageRights; otherwise returns 400 USAGE_RIGHTS_UNAVAILABLE (unsupported).
{ "start": "2026-11-01", "end": "2026-11-30", "constraints": [ { … }, { … } ] }
If no sorting is provided, requests containing a full-text (query.text) or visual (query.visual) search are sorted by relevance; all other requests are sorted by modified_on descending.
Culture/language code used to localize multilingual returned values, for example en-US. Defaults to the caller's preferred culture, falling back to en-US.
- https://your-serverhttps://your-server/api/v1/dam/assets/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://your-server/api/v1/dam/assets/search \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"text": "string",
"visual": {
"mode": "asset",
"value": "string"
}
},
"filters": [],
"exclusions": [],
"include": {
"fields": [],
"taxonomies": [],
"relations": [],
"renditions": []
},
"usageRights": {
"start": "2026-11-01",
"end": "2026-11-30",
"constraints": [
{
"key": "territories",
"operator": "anyOf",
"values": [
"territory-germany",
"territory-france"
]
},
{
"key": "media",
"operator": "allOf",
"values": [
"media-online"
]
}
]
},
"sorting": {
"field": "string",
"direction": "asc"
},
"culture": "string",
"skip": 0,
"take": 10
}'Successful operation
{ "culture": "string", "skip": 0, "take": 0, "total": 0, "items": [ { … } ] }