Overview
What Rumoro does, how a post becomes a mention in your feed, and how to build on it.
Rumoro is social listening for developers and AI agents. You choose the words to watch, such as your product, your competitors or your field. Rumoro finds them on X, Bluesky, Hacker News, Reddit, GitHub, Stack Overflow, DEV, YouTube, LinkedIn, TikTok, Instagram and in the news, and in reviews on the App Store, Google Play, Trustpilot and Google. Each mention is scored for relevance, sentiment and intent. You read them in one feed, triage them, and send them wherever you work.
From post to feed
- Find. Rumoro checks each platform on its own schedule and reads Bluesky live. A new keyword also gets recent posts from the last 30 days.
- Match. Each post is compared with every keyword that covers its platform, using the keyword's rules.
- Score. A model reads your company profile and rates the mention. You get relevance from 0 to 100, sentiment, intents like
buy_intentorcomplaint, and a one-line note. - Send. Alert rules send relevant mentions right away, or in an hourly, daily or weekly digest, to Slack, Telegram, email or a signed webhook.
You pay for every matched mention, relevant or not. Rules send only relevant ones unless you lower minRelevance (0 sends everything). More in How it works.
Ways in
REST API
Every operation over HTTP.
SDKs
Typed clients for TypeScript and Python.
CLI
Run any endpoint from your terminal, or stream new mentions.
MCP server
Let AI agents use Rumoro as tools.
Webhooks
A signed request for each mention or digest.
Alerts
Mentions in Slack, Telegram or email.
The SDKs, the CLI and the MCP server use the operations in the OpenAPI document, so fields have the same names everywhere.
The model
| Resource | What it is | Reference |
|---|---|---|
| Keywords | Terms you track (brand, competitor, topic), with their platforms, matching rules (required and excluded terms, excluded authors, case) and context for the classifier. | /v1/keywords |
| Groups | Keywords grouped by customer, campaign or product. Each group can have its own company description and its own bill. | /v1/groups |
| Filters | Workspace rules that drop noise, such as excluded terms, authors, GitHub repositories and subreddits. Dropped posts are never stored or billed. | /v1/filters |
| Mentions | A post matched to a keyword, with its scores, your verdict and triage (open, ignored or done, assignee, snooze, note). | /v1/mentions |
| Views | Saved mention filters. | /v1/views |
| People | The authors behind mentions, with reach, profile, tags, notes and mutes. | /v1/people |
| Segments | Saved people filters that are always up to date. | /v1/segments |
| Alerts and channels | Rules that send mentions to Slack, Telegram, email or webhooks, right away or as digests. | /v1/alerts |
| Attention | Hourly checks for spikes, negative turns, noisy keywords and failing channels. | /v1/attention |
| Analytics | Five reports. Summary, series, breakdown, share of voice and reviews. | /v1/analytics |
| Company | Your description, use cases, competitors and guidelines. The classifier reads it, so it matters most for relevance. | /v1/company |
| Members | Your team, roles and invitations. Any credential can read them. Changes need a signed-in owner or admin, in the dashboard or through OAuth. API keys can't change the team. | /v1/members |
| Usage and billing | Balance, daily cost, billed keywords and matches. | /v1/usage |
| API keys | read or write keys for one workspace, with an optional expiry. GET /v1/whoami tells you which key is calling. | /v1/api-keys |
Start here
- Quickstart creates a keyword, sets your company profile, searches and triages, in five calls.
- Authentication and Conventions cover keys, scopes, response shapes, ids and errors.
- Alerts sends mentions to you. Billing explains the prepaid balance.
- Building with an agent? Connect the MCP server or give it llms.txt.