How to search by Tags in DAM?

As part of using DAM, you may need to find one or more assets (images, videos, documents). One of the most efficient ways to do this is by searching using Tags. 

You can search by tags in two ways:

1. Using the DAM Asset Hub

2. Using the DAM API

 

1. Searching by Tags in the Asset Hub

Using the search bar

1. Log in to the DAM Asset Hub.

2. In the search bar, type the tag name you want to search for, prefixed with the # symbol.

   Tip: Tags must always start with #. Searching without it will trigger a general search that returns matches in filenames, descriptions and metadata. 

   Example: To find an asset tagged Cloud, type #Cloud

     3.The search results will display all assets associated with that tag.

Note: Tags are not case-sensitive. It means that searches by #Cloud and #cloud will produce the same results.

Using the Filters Panel

1. Log in to the DAM Asset Hub.

2. Click on Add filters
   

3. Select Tags.
   

4. Select the tag you want to search for from the list. 

   Example: Select Cloud from the Tags list.
   

5. The results update automatically and show all assets tagged with Cloud.

2. Search by tags using the DAM API

You can also search for assets programmatically using the DAM API.

Step 1: Construct the API request

curl --request GET \
  --url 'https://api.filerobot.com/TOKEN/v5/files?q=%23Your_Tag_Name' \
  --header 'Content-Type: application/json' \
  --header 'X-Filerobot-Key: YOUR_API_KEY'

Important notes:

• The # symbol must be URL-encoded as %23 .

  • Example:#Cloud → %23Cloud

• Replace the placeholders:

  • TOKEN→ your DAM project token

  • YOUR_API_KEY → your API key or the SASS key generated from a Security Template. 

  • Your_Tag_Name→ the tag you want to search

Step 2: Example

To search for assets tagged with Cloud:

curl --request GET \
  --url 'https://api.filerobot.com/TOKEN/v5/files?q=%23Cloud' \
  --header 'Content-Type: application/json' \
  --header 'X-Filerobot-Key: YOUR_API_KEY'

The successful response will return a list of files and their metadata. 

3. Additional Information

• q is a query string parameter that searches for a specific pattern matching the tag name

• You can combine tag searches with other filters (size, mimetype, resolution, etc.). 

For detailed information, refer to the official documentation:
DAM API Documentation

If you have any questions or issues, please feel free to contact our Support Team and mention the following details:

• Token

• in case of API issue → include full request + response

• in case of Asset Hub issue → include screenshot of filters/search bar and steps how to reproduce the problem

• in case of missing results → include asset filename and tag name which is used for the search