Copy as markdown[View .md](https://docs.funnelfizz.com/features/mentions "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Ffeatures%2Fmentions.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Mentions "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Ffeatures%2Fmentions.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Mentions "Open this page in ChatGPT with context")

# Mentions

**Mentions** is a PRO feature that continuously scans the internet for mentions of your brand and rolls them up into an AWARENESS-stage dashboard widget.

It answers questions like:

* How much buzz is my launch getting this week?
* Are people talking about us on HackerNews or Reddit?
* What's the sentiment breakdown — are we getting roasted or celebrated?

## What gets scanned[​](#what-gets-scanned "Direct link to What gets scanned")

Thirteen sources. Some need no auth, some need a workspace-level OAuth connection, some use environment-level API keys FunnelFizz manages.

| Source               | Auth       | Coverage                                  |
| -------------------- | ---------- | ----------------------------------------- |
| HackerNews (Algolia) | None       | All mentions in stories and comments      |
| Google News RSS      | None       | News articles syndicated to Google News   |
| Stack Exchange       | None       | Questions and answers across all SE sites |
| DEV.to               | None       | Articles and comments                     |
| Brave Search         | FF key     | Web search result scrape                  |
| GitHub               | FF token   | Issues, PRs, commits, READMEs             |
| ProductHunt          | FF token   | Product launches, comments                |
| X (Twitter)          | Your OAuth | Posts and quote-tweets                    |
| Reddit               | Your OAuth | Posts and comments                        |
| Instagram            | Your OAuth | Caption mentions (limited)                |
| TikTok               | Your OAuth | Video title mentions                      |
| YouTube              | Your OAuth | Video title + description mentions        |
| LinkedIn             | Your OAuth | Post mentions                             |

For the sources that use your own OAuth (X, Reddit, Instagram, TikTok, YouTube, LinkedIn), connect the provider first ([Providers](https://docs.funnelfizz.com/features/providers.md)) — Mentions re-uses those credentials. No extra connection step needed.

## How it works[​](#how-it-works "Direct link to How it works")

1. You configure a **brand monitor** — brand name + optional keywords + optional exclusions.
2. FunnelFizz runs a cron every hour that fans out queries across all 13 sources.
3. Results are deduplicated by `externalId` (platform-specific, e.g., HN story ID, Reddit post ID) so the same mention isn't counted twice even if it bubbles up on multiple scans.
4. Results are stored with source, URL, excerpt, timestamp, and an auto-derived sentiment (positive / neutral / negative).
5. The dashboard shows totals, daily trend, top sources, recent mentions feed.

## Setting up a brand monitor[​](#setting-up-a-brand-monitor "Direct link to Setting up a brand monitor")

Go to any **CUSTOMER stage** on your canvas and click the **Mentions** tab.

1. **Brand name** — exact string to match. Case-insensitive. E.g., `FunnelFizz`.
2. **Inclusion keywords** (optional) — at least one must also be present. E.g., `marketing`, `funnel`, `conversion`. Useful to disambiguate common brand names.
3. **Exclusion keywords** (optional) — if any are present, the mention is skipped. E.g., `not funnelfizz`, `fake funnelfizz` to prevent trolling and spam from counting.

Click **Start monitoring** and the first scan kicks off immediately. Subsequent scans run hourly.

## What you see on the dashboard[​](#what-you-see-on-the-dashboard "Direct link to What you see on the dashboard")

* **Total mentions** in the selected period.
* **Sources breakdown** — pie chart, mentions per source.
* **Daily trend** — line chart, last 7 / 30 / 90 days.
* **Sentiment** — stacked bar: positive / neutral / negative.
* **Recent mentions feed** — 20 most recent, each with link out to the source, excerpt, author/handle, timestamp.

Clicking any mention opens the original source in a new tab. We don't republish the full text (copyright, attribution); you get the excerpt + link.

## Sentiment[​](#sentiment "Direct link to Sentiment")

Sentiment is derived automatically from the mention text using keyword classification (positive signal words, negative signal words, emoji, punctuation, etc.). It's approximate — use the feed to spot-check anything that looks surprising.

## Constraints[​](#constraints "Direct link to Constraints")

* **One brand per workspace.** PRO plan includes one brand monitor. If you need to track multiple products, each needs its own workspace.
* **Hourly sync is the cadence.** Don't refresh every 30 seconds hoping for new mentions — the API rate limits across providers make that uneconomical.
* **Old mentions aren't backfilled.** We start scanning the moment you enable monitoring. Mentions older than that won't appear unless the source's API returns them in current searches (HackerNews does, most don't).

## What it costs[​](#what-it-costs "Direct link to What it costs")

Mentions is a PRO-only feature. FunnelFizz covers the third-party API costs for the keyless and FF-keyed sources. You cover the OAuth-based ones via the quota your own platforms allow you (most have generous free tiers).

## Privacy & ethics[​](#privacy--ethics "Direct link to Privacy & ethics")

* We scan public content only. No scraping of private groups, DMs, or gated communities.
* If a source's robots.txt or ToS disallows scraping, we honor it.
* We store the excerpt + URL, not a full copy of the source content.
* Deletion: if a mention is deleted at the source, we don't retroactively remove it from your dashboard, but the link will 404.

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

* **"No mentions yet" after 2 hours.** Try a broader query — drop exclusion keywords, or check your brand name isn't misspelled. You can test manually with the **"Run scan now"** button in settings.
* **Too many false positives.** Add inclusion keywords to require context words, or add exclusion keywords for the common false matches.
* **Missing a source.** Make sure the corresponding provider OAuth is connected (for X, Reddit, etc.) or that your workspace has the feature enabled in your plan.

***

**Next:** [SEO →](https://docs.funnelfizz.com/features/seo.md) — dashboard widget for search performance (preview).