Searching by Tag

Many SHIFT users organizer their media using tags. You can find your media files using the tags you've applied to them.

Searching for a specific tag

Let's start by finding all files that have the tag "broll".

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 lots of b-roll. 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'

Let's also consider that you may want everything but b-roll. Let's get our files that are 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?