Skip to main content
Automation

Social listening

Monitor keywords and brand names across public sources, then share or reply from the composer.

Monitors

Open Listening and create a monitor: a name, up to 10 keywords or phrases, optional brand handles, optional phrases to ignore, the sources to search and how often to check (every 15 minutes to once a day). A mention matches when it contains any keyword or handle and none of the ignored phrases. Each workspace can have 10 monitors.

New mentions land in the Mentions feed with a source badge, the author and the time in IST. Use Share / Reply to open the composer with the link and a short quote filled in, Save to keep a mention (saved mentions are never deleted) or Dismiss to hide it. Mentions that are not saved are removed after 90 days.

Sources

Only official or documented, free-to-call interfaces are used. A source that is not set up for a workspace is skipped and shown as such on the monitor; it never blocks the others.

SourceWhat it needsLimits
Hacker NewsNothing (Algolia search API).Stories and comments; public API.
Google NewsNothing (public RSS search feed).About 100 items per check; Google publishes no formal service guarantee for this feed.
RSS / Atom feedsFeed URLs you add to the monitor (https, public hosts, up to 5).1 MB and 10 seconds per feed. Items are kept when they contain your keywords.
RedditReddit developer app keys saved for the workspace (Accounts, Reddit). Reddit may require approval before new API credentials work.About 100 requests per minute for OAuth apps; up to 100 posts per search. Posts only, not comments.
BlueskyA connected Bluesky account in the workspace. Bluesky search needs a signed-in session.Up to 100 posts per request.
MastodonA connected Mastodon account whose access token has the read:search scope. Reconnect with that scope if checks fail with an authorization error.Up to 40 posts per request; search covers what your instance has seen. Some instances disable full-text search.
X (Twitter)A connected X account and API credits on your X developer account. X charges for reading posts, so checks fail with a payment error when there are no credits.Recent search only reaches back 7 days.
YouTubeNot available. Its search costs 100 of the 10,000 free daily quota units per call, which does not scale to continuous monitoring.Not offered.

Sentiment and summary

When the server has an AI provider configured, a monitor can tag each new mention as positive, neutral or negative with a one-line summary. It runs in the background after the mentions are saved, is stored with the mention (never recomputed) and never delays collection. If the provider fails, the mentions are still collected.

API and MCP

  • GET/POST /api/listening/monitors, PATCH/DELETE /api/listening/monitors/:id, POST /api/listening/monitors/:id/run.
  • GET /api/listening/matches (filters: monitor_id, source, status, sentiment, q, from, to; limit/offset), PATCH /api/listening/matches/:id with status new, saved or dismissed.
  • GET /api/listening/stats (volume per day in IST, top sources and authors) and GET /api/listening/sources.
  • MCP tool list_mentions (read only).
  • Every workspace member can read; creating monitors and saving or dismissing mentions needs the create content permission.

v0.1.2

Social listening | Documentation | Sociquza