Content Views

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

Content Views are saved filters in your Social Listening section. They let you quickly access a specific slice of your content — for example, “Influencer-Generated Content”, “High-Engagement UGC”, or custom views you’ve created like “Wedding” or “Unboxing”.

In the Archive UI, these appear under Social Listening → Content Views in the sidebar. Looking for Collections instead? See Collections — those are static groups of items you manually curate, while Content Views are dynamic filters that update automatically.

Learn more: Creating, Deleting, and Renaming Content Views 

List your Content Views

Content Views are returned by the filterPresets query with accessor: MEDIA_DECK:

query ListContentViews {
  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": "Unboxing", "accessor": "MEDIA_DECK" }
    ]
  }
}

This query returns both Content Views (MEDIA_DECK) and Collections (COLLECTIONS). Filter by accessor to separate them.

Using with AI:

“List all my Content Views” “Show me only my saved views, not collections”

Get items from a Content View

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

query ItemsFromView {
  items(first: 20, presetId: "c1d2e3f4-a5b6-7890-cdef-012345678901") {
    totalCount
    nodes {
      id
      caption
      type
      provider
      takenAt
      currentEngagement { likes comments views }
      socialProfile { accountName followers }
    }
  }
}

Example response:

{
  "data": {
    "items": {
      "totalCount": 1250,
      "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 ‘Unboxing’ view” “How many items are in my ‘High-Engagement UGC’ view?”

Sort items within a Content View

You can sort the results from a Content View using sorting:

query ViewMostLiked {
  items(
    first: 10
    presetId: "c1d2e3f4-a5b6-7890-cdef-012345678901"
    sorting: { sortKey: LIKE_COUNT, sortOrder: DESC }
  ) {
    totalCount
    nodes {
      id type provider
      currentEngagement { likes }
      socialProfile { accountName }
    }
  }
}

Example response:

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

Using with AI:

“Show me the most liked items in my ‘Unboxing’ view” “Rank content in my ‘Influencer-Generated Content’ view by EMV” “What are the top 10 most viewed posts in my ‘High-Engagement UGC’ view?”

Get a specific Content View by name

If you know the name of the view you want, list all presets and match by name:

query FindView {
  filterPresets {
    id
    name
    accessor
  }
}

Then use the id of the matching preset as presetId in your items query.

Using with AI:

“Find my Content View called ‘Unboxing’ and show me the items in it” “What’s the ID of my ‘High-Engagement UGC’ view?”

Count items in a Content View

A quick way to see how much content a view contains without fetching all items:

query ViewCount {
  items(first: 1, presetId: "c1d2e3f4-a5b6-7890-cdef-012345678901") {
    totalCount
  }
}

Example response:

{
  "data": {
    "items": {
      "totalCount": 1250
    }
  }
}

Using with AI:

“How many items are in each of my Content Views?” “Which of my views has the most content?”

Get engagement data from a Content View

Pull engagement metrics for the content in a view — useful for reports:

query ViewEngagement {
  items(
    first: 20
    presetId: "c1d2e3f4-a5b6-7890-cdef-012345678901"
    sorting: { sortKey: EARNED_MEDIA_VALUE, sortOrder: DESC }
  ) {
    totalCount
    nodes {
      id
      caption
      type
      provider
      takenAt
      currentEngagement {
        likes
        comments
        shares
        views
        impressions
        earnedMediaValue
      }
      socialProfile { accountName followers }
    }
  }
}

Using with AI:

“Show me the EMV breakdown for my ‘Influencer-Generated Content’ view” “What’s the total engagement across all items in my ‘Unboxing’ view?” “Give me a performance summary of my ‘High-Engagement UGC’ view”

Important notes

Content Views are read-only via the API. You can query items from a view and sort them, but you cannot create, edit, or delete Content Views through the API. To manage views, use the Archive UI.

Filters cannot be combined with presets. When you use presetId, the view’s own filters are applied. Adding filter parameters to the query will not narrow the results further. Use sorting to change the order instead.