Collections

Reminder: All queries and mutations on this page require the WORKSPACE-ID header. See Getting Started for setup.

Collections are static groups of items you manually curate — for campaigns, reports, client deliverables, or any workflow your team needs. Unlike Content Views (which are dynamic saved filters that update automatically), collections only change when you add or remove items.

In the Archive UI, these appear under Social Listening → Collections in the sidebar.

Learn more: All About Collections

List all collections and filter presets


query ListFilterPresets {
  filterPresets {
    id
    name
    accessor
  }
}

Example response:


{
  "data": {
    "filterPresets": [
      { "id": "c1d2e3f4-a5b6-7890-cdef-012345678901", "name": "Influencer-Generated Content", "accessor": "MEDIA_DECK" },
      { "id": "d2e3f4a5-b6c7-8901-defa-123456789012", "name": "High-Engagement UGC", "accessor": "MEDIA_DECK" },
      { "id": "e3f4a5b6-c7d8-9012-efab-234567890123", "name": "Q1 Campaign Content", "accessor": "COLLECTIONS" }
    ]
  }
}

accessor tells you where the preset lives in the Archive UI:

MEDIA_DECK — a saved filter in your Media Deck
COLLECTIONS — a collection of items

Using with AI:

“List all my saved filters and collections” “Get the ID of my collection called ‘Q1 Campaign Content‘“

Get items from a collection

Use the collection’s id as presetId in an items query:


query ItemsFromCollection {
  items(first: 20, presetId: "e3f4a5b6-c7d8-9012-efab-234567890123") {
    totalCount
    nodes {
      id
      caption
      type
      provider
      takenAt
      currentEngagement { likes comments views }
      socialProfile { accountName followers }
    }
  }
}

Example response:


{
  "data": {
    "items": {
      "totalCount": 21,
      "nodes": [
        {
          "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890",
          "caption": "Summer linen set — obsessed with this look for travel",
          "type": "REEL",
          "provider": "INSTAGRAM",
          "takenAt": "2026-03-28T14:30:00Z",
          "currentEngagement": {
            "likes": "8420",
            "comments": "213",
            "views": "94000"
          },
          "socialProfile": {
            "accountName": "lauramendez",
            "followers": 312000
          }
        }
      ]
    }
  }
}

Using with AI:

“Show me all items in my ‘Q1 Campaign Content’ collection” “How many items are in my ‘Unboxing’ collection?”

Get items from a collection with sorting

You can combine presetId with sorting to order the results:


query CollectionMostLiked {
  items(
    first: 10
    presetId: "e3f4a5b6-c7d8-9012-efab-234567890123"
    sorting: { sortKey: LIKE_COUNT, sortOrder: DESC }
  ) {
    totalCount
    nodes {
      id type provider
      currentEngagement { likes }
      socialProfile { accountName }
    }
  }
}

Example response:


{
  "data": {
    "items": {
      "totalCount": 21,
      "nodes": [
        {
          "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890",
          "type": "REEL",
          "provider": "INSTAGRAM",
          "currentEngagement": { "likes": "8420" },
          "socialProfile": { "accountName": "lauramendez" }
        }
      ]
    }
  }
}

Using with AI:

“Show me the most liked items in my ‘Q1 Campaign Content’ collection” “Rank content in my ‘Unboxing’ collection by EMV”

Add an item to a collection


mutation AddToCollection {
  addItemToCollections(
    itemId: "a4b1c2d3-e5f6-7890-abcd-ef1234567890"
    collectionNames: ["Q1 Campaign Content"]
    autoCreate: true
  ) {
    item { id }
    userErrors { field message }
  }
}

Example response:


{
  "data": {
    "addItemToCollections": {
      "item": { "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890" },
      "userErrors": []
    }
  }
}

About autoCreate: When set to true, if the collection name you pass doesn’t exist yet, it will be created automatically. The new collection will appear in the Archive UI under your Collections and in the filterPresets query with accessor: COLLECTIONS. If the collection already exists, the item is simply added to it.

You can also use collectionIds instead of collectionNames if you already have the collection’s UUID:


mutation AddByCollectionId {
  addItemToCollections(
    itemId: "a4b1c2d3-e5f6-7890-abcd-ef1234567890"
    collectionIds: ["e3f4a5b6-c7d8-9012-efab-234567890123"]
  ) {
    item { id }
    userErrors { field message }
  }
}

Using with AI:

“Add this item to my ‘Q1 Campaign Content’ collection” “Create a new collection called ‘Best of March’ and add this item to it”

Add an item to multiple collections at once

Pass multiple names in collectionNames:


mutation AddToMultipleCollections {
  addItemToCollections(
    itemId: "a4b1c2d3-e5f6-7890-abcd-ef1234567890"
    collectionNames: ["Q1 Campaign Content", "Best of March", "Client Review"]
    autoCreate: true
  ) {
    item { id }
    userErrors { field message }
  }
}

Example response:


{
  "data": {
    "addItemToCollections": {
      "item": { "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890" },
      "userErrors": []
    }
  }
}

Using with AI:

“Add this item to both ‘Q1 Campaign Content’ and ‘Best of March’” “Add all high-virality Reels from March to ‘Client Review’ and ‘Top Performers‘“

Remove an item from a collection


mutation RemoveFromCollection {
  removeItemFromCollections(
    itemId: "a4b1c2d3-e5f6-7890-abcd-ef1234567890"
    collectionNames: ["Q1 Campaign Content"]
  ) {
    item { id }
    userErrors { field message }
  }
}

Example response:


{
  "data": {
    "removeItemFromCollections": {
      "item": { "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890" },
      "userErrors": []
    }
  }
}

Using with AI:

“Remove this item from my ‘Q1 Campaign Content’ collection”

Remove an item from multiple collections at once


mutation RemoveFromMultipleCollections {
  removeItemFromCollections(
    itemId: "a4b1c2d3-e5f6-7890-abcd-ef1234567890"
    collectionNames: ["Q1 Campaign Content", "Best of March"]
  ) {
    item { id }
    userErrors { field message }
  }
}

Example response:


{
  "data": {
    "removeItemFromCollections": {
      "item": { "id": "a4b1c2d3-e5f6-7890-abcd-ef1234567890" },
      "userErrors": []
    }
  }
}

Using with AI:

“Remove this item from both ‘Q1 Campaign Content’ and ‘Best of March’” “Clean up: remove this item from all collections”

Always check userErrors — if something went wrong, the details appear there. A successful response has "userErrors": [].