Searching by Tag

Many Shift users organize their media using tags. You can find files by searching for the tags you applied to them.

Searching for a specific tag

Let's start by finding all files that have the tag "broll" (as in "b-roll footage").

curl --request GET \
  --url https://api.shift.io/v3/assets?tags={"eq":"broll"} \
  --header 'accept: application/json' \
  --header 'x-key: YOUR_API_KEY' \
  --header 'x-secret: YOUR_API_SECRET'

This might return many files, especially if you have a lot of b-roll footage. Let's narrow this down by finding all of our Catalina b-roll.

curl --request GET \
  --url https://api.shift.io/v3/assets?tags={"in":"broll,catalina"} \
  --header 'accept: application/json' \
  --header 'x-key: YOUR_API_KEY' \
  --header 'x-secret: YOUR_API_SECRET'

You can also search for everything that is not b-roll.

curl --request GET \
  --url https://api.shift.io/v3/assets?tags={"nin":"broll"} \
  --header 'accept: application/json' \
  --header 'x-key: YOUR_API_KEY' \
  --header 'x-secret: YOUR_API_SECRET'

Did this page help you?