Views

A view is a saved filter for your mentions with a name, such as "Negative about us" or "Questions from big accounts". Switch between views on the Mentions page, or send a view's id as viewId to the API. Views don't store mentions. A view shows whatever matches its filter at the moment you open it.

The filterCopy Anchor Link

A view's filter takes the same fields as GET /v1/mentions.

• keywordIds, keywordKinds (brand, competitor, topic) and groupIds (groups)
• platforms, languages, linkHosts, ratings and isReply
• relevant, minRelevance, minConfidence, sentiments, intents and automated
• minFollowers, maxFollowers, tags and excludeAuthors
• minLikes, minReposts, minReplies, minQuotes, minViews and minBookmarks
• status, and q, which searches the post text, title, matched term and author handle

A list matches any of its values. The not lists, such as notPlatforms, notGroupIds, notIntents or notTags, exclude all of theirs. All conditions must hold, and an empty filter matches every mention. To combine conditions with OR, use anyOf with 1 to 10 groups (Conventions). A view has no time window, and no person, assignee or snooze setting.

name is 1 to 80 characters and unique, ignoring case (409 duplicate_view). description can be up to 500 characters.

const { data: view } = await rumoro.createView({
  body: {
    name: 'Questions from big accounts',
    description: 'Reply within the hour.',
    filter: { intents: ['question'], minFollowers: 1000, status: 'open' },
  },
});

Reading a viewCopy Anchor Link

viewId works together with all other parameters, so adding since gives you one period. It also works on export.csv and export.json. An unknown id returns 404.

const { data: page } = await rumoro.searchMentions({ query: { viewId: 'vw_...', since: '2026-10-01T00:00:00Z' } });

On the Mentions pageCopy Anchor Link

The view switcher is the first control in the toolbar, and filter chips narrow the view you're on. Create view appears once you've set a filter or search. Edit opens a view with its own filter chips, and Manage views lets you edit or delete any view. anyOf groups set through the API stay when you edit in the dashboard.

Views and alertsCopy Anchor Link

A view is for reading, an alert is for being notified. You can read an alert rule's filter the same way with alertId. To turn a view into an alert, send its filter to POST /v1/alerts. A field that alerts don't support returns 400.