# Brand Mentions Monitor - Bluesky, Hacker News & Mastodon (`tenfoldfleet/brand-mentions-monitor`) Actor

Monitor brand mentions on Bluesky, Hacker News and Mastodon: each run returns only posts and comments new since the last run. Rows: source, keyword, text, author, link, date, likes, replies. $2.50 per 1,000 new mentions + $0.001 per keyword per run; repeats and errors are free.

- **URL**: https://apify.com/tenfoldfleet/brand-mentions-monitor.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Social media, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 mentions

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Not affiliated with Bluesky, Hacker News, Y Combinator or Mastodon. This Actor reads only public APIs that anyone can call without an account.

### What does Brand Mentions Monitor do?

**Brand Mentions Monitor** watches **Bluesky**, **Hacker News** and **Mastodon** for new posts and comments that name your **brand, product, competitors or any keyword**, and returns only what appeared since its previous run. Save it as a task, put it on a schedule, and each run hands you a short list of fresh mentions in one table, already deduplicated across sources and across runs.

It works as a **social listening API** for the open, developer-heavy corners of the web: send a list of keywords, get one row per mention with the source, the keyword that matched, a text snippet, the full text, author, link, post time and engagement counts (likes, reposts, replies, points).

- Bluesky is searched in full text through its public search API.
- Hacker News stories and comments are searched in full text through the public Algolia search API.
- Mastodon is read through public **hashtag timelines** (see below), by default on mastodon.social.

Every hit is re-checked in the post text before it is returned, so fuzzy search results that don't really contain your keyword are dropped and never charged.

### Why use it?

- **Brand monitoring for developer tools and SaaS**: Hacker News and Bluesky are where engineers and founders talk about tools. See every new thread that names your product while it is still active.
- **Competitor tracking**: follow competitor names and catch launches, complaints, outages and "we switched from X" stories.
- **Keyword alerts**: watch phrases such as "alternative to Notion" or "looking for a CRM" to find buying-intent posts.
- **Launch and PR tracking**: count new mentions per day after a Show HN, a release or a press story.
- **One feed for three networks**: one schedule and one dataset instead of three separate scrapers and your own dedup logic.

For Reddit use [Reddit Brand Monitoring](https://apify.com/tenfoldfleet/reddit-brand-monitoring), and for Telegram channels use [Telegram Keyword Search Monitor](https://apify.com/tenfoldfleet/telegram-keyword-search-monitor). Both work the same way: only new mentions on each run.

### What data can it extract?

![Sample output of Brand Mentions Monitor, rows from a real run: Source, Keyword, Type, Snippet, Author, Link](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/brand-mentions-monitor-output.png)

| Field | What it is |
|---|---|
| `source` | `bluesky`, `hackernews` or `mastodon` (error rows have `error` instead) |
| `keyword`, `matchedKeywords` | the keyword this mention is filed under, and every monitored keyword it contains |
| `type` | `post` or `reply` (Bluesky, Mastodon), `story` or `comment` (Hacker News) |
| `title` | Hacker News story title (for a comment: the story it belongs to), or the title of a shared link card |
| `snippet`, `text` | about 280 characters around the keyword, and the full plain text |
| `author`, `authorName`, `authorUrl` | handle, display name and profile link |
| `authorFollowers` | follower count (Mastodon only; the other APIs don't return it) |
| `url`, `id` | link to the post and a stable id (`bluesky:at://...`, `hackernews:123`, `mastodon:` plus the post URI) |
| `createdAt` | when it was posted (UTC) |
| `likes`, `reposts`, `replies`, `quotes` | engagement at the time of the run (Hacker News: points and comment count for stories) |
| `language`, `hashtags` | language tag and hashtags of the post |
| `linkUrl`, `parentUrl` | link shared in the post, and the parent post or story |
| `instance`, `monitorName`, `matchedAt` | Mastodon server, the monitor's name and when this run found it |

A run summary (keywords, sources, pages read, problems, what was filtered) is saved as `SUMMARY` in the run's key-value store.

### How to monitor brand mentions on Bluesky, Hacker News and Mastodon

1. Add your **keywords**: brand names, product names, competitor names or phrases, one per line (up to 50 per run).
2. Pick the **sources** (all three by default).
3. Choose how a keyword must appear: **Exact phrase** (default), **All words** or **Any word**. Add **exclude words** to skip noise, and optionally limit **languages**.
4. Pick how far the first run looks back: past hour, 24 hours, week (default) or 30 days.
5. Click **Start**. The first run returns the backlog. Save the input as a task and add a **schedule** (for example every hour or every morning). From then on each run returns only new mentions.
6. To get alerts, connect the task to Slack, email, Google Sheets, Make, Zapier or a webhook with [Apify integrations](https://apify.com/integrations), or read results through the Apify API.

### How Mastodon coverage works

Mastodon has no public full-text search: searching post text needs a signed-in account, and this Actor never logs in. So for Mastodon each keyword is turned into a **hashtag** ("Brand Mentions" becomes #BrandMentions, "Cloudflare" becomes #Cloudflare) and that hashtag's public timeline is read on the servers you list. Your exclude words and language filter still apply to the text. This means Mastodon returns **posts tagged with your brand**, not every post that names it in plain text. mastodon.social is the default because it is the largest server and sees posts from across the network; small servers often return nothing for niche tags.

### How much does it cost?

Pay per event: you pay for the new mentions you get and for each keyword checked per run.

| Event | Price |
|---|---|
| Mention (one new post, story or comment that contains your keyword) | **$2.50 per 1,000** ($0.0025 each) |
| Keyword scan (one keyword searched on the selected sources in one run) | **$0.001 per keyword per run** |
| Run start | $0.00005 per run |

**Examples:** 5 keywords checked once a day for a month cost 5 x 30 x $0.001 = **$0.15** in keyword scans, plus $0.0025 per new mention (200 new mentions = $0.50). The same 5 keywords checked every hour cost 5 x 720 x $0.001 = $3.60 a month in scans.

**Free:** mentions already returned by earlier runs of the same monitor, posts with an exclude word, search hits that don't really contain the keyword, mentions over your per-source limit, and error rows. A keyword that no source could search is not charged. No proxy is needed, and compute is included.

**Free Apify plan:** at most 50 mentions per run. Any paid plan removes the limit.

### Input

```json
{
    "keywords": ["Shopify", "Cloudflare"],
    "sources": ["bluesky", "hackernews", "mastodon"],
    "monitorName": "my-brand",
    "onlyNewMentions": true,
    "timeWindow": "week",
    "matchMode": "phrase",
    "excludeWords": ["hiring"],
    "maxMentionsPerSource": 100,
    "mastodonInstances": ["mastodon.social"]
}
```

### Output

```json
{
    "source": "bluesky",
    "keyword": "Cloudflare",
    "matchedKeywords": ["Cloudflare"],
    "type": "post",
    "title": null,
    "snippet": "Moved our static site to Cloudflare Pages last week and the build times dropped from 4 minutes to 40 seconds.",
    "text": "Moved our static site to Cloudflare Pages last week and the build times dropped from 4 minutes to 40 seconds.\n\nAnyone else made the switch?",
    "author": "example.bsky.social",
    "authorName": "Example Dev",
    "authorUrl": "<link to the author's Bluesky profile>",
    "url": "<link to the post on Bluesky>",
    "id": "bluesky:at://did:plc:exampleexampleexample/app.bsky.feed.post/3mexample0001",
    "createdAt": "2026-11-07T03:51:10.421Z",
    "likes": 4,
    "reposts": 0,
    "replies": 2,
    "language": "en",
    "hashtags": [],
    "monitorName": "my-brand",
    "matchedAt": "2026-11-07T14:58:03.120Z"
}
```

Download results as JSON, CSV, Excel, XML or HTML, or read them through the Apify API.

### Tips

- Give each brand or client its own **monitor name**, so their memories of returned mentions stay separate.
- Short or common brand names ("Notion", "Linear") need **exclude words** to keep the noise down.
- No quotes needed: with Exact phrase, "brand monitoring" matches "Brand Monitoring", "brand-monitoring" and "brand_monitoring".
- Busy keywords on Bluesky can produce hundreds of posts a day. Raise **Max new mentions per keyword per source** or schedule more often so nothing is skipped.
- Turn off **Only new mentions** for a one-off historical pull of the time window.

### FAQ

#### Does it need a Bluesky, Hacker News or Mastodon account?

No. All three sources are read through public APIs without logging in.

#### How does "only new mentions" work?

Each monitor keeps a memory of the mention ids it returned and where each keyword's last complete scan ended. The next run starts from there (with a 30-minute overlap for late indexing) and skips anything already returned, so you never pay twice for the same post.

#### Why are some Mastodon posts missing?

Mastodon is covered by hashtag only (see "How Mastodon coverage works"). A post that names your brand without the hashtag can't be found without a signed-in account.

#### Can I monitor Reddit or X (Twitter) too?

Reddit is covered by our separate [Reddit Brand Monitoring](https://apify.com/tenfoldfleet/reddit-brand-monitoring) Actor. X is not included.

#### Is it legal to monitor public posts?

This Actor reads only public posts through public APIs. Results can include usernames and post text, which may be personal data under GDPR or similar laws. Use them only for a legitimate purpose and follow the rules that apply to you.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [ChatGPT Search Scraper: Brand Mentions & Citations per Prompt](https://apify.com/tenfoldfleet/chatgpt-search-scraper-answers-citations-brand-mentions) | prompt answered |
| [Bilibili Scraper - Videos, Comments, Danmaku & Search](https://apify.com/tenfoldfleet/bilibili-scraper) | video or comment |
| [Douban Reviews Scraper - Movies, Books, TV & Groups](https://apify.com/tenfoldfleet/douban-reviews-scraper) | review |
| [Facebook Ads Library Scraper for Marketers](https://apify.com/tenfoldfleet/facebook-ads-library-scraper) | ad |
| [Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle](https://apify.com/tenfoldfleet/facebook-ads-transcript) | video ad transcript |
| [Facebook Reels Scraper: Views & Captions Monitor for Any Page](https://apify.com/tenfoldfleet/facebook-reels-scraper) | reel |
| [Facebook Reels Transcript - Facebook Video to Text, No Login](https://apify.com/tenfoldfleet/facebook-reels-transcript) | reel transcript |
| [Instagram Post Details Scraper - Carousel, Likes, Caption](https://apify.com/tenfoldfleet/instagram-post-details) | post |
| [Instagram Profile Transcript Monitor - New Reels to Text](https://apify.com/tenfoldfleet/instagram-profile-transcript-monitor) | new reel transcript |
| [Instagram Reels Analytics - Profile Reel Plays, Likes, Comments](https://apify.com/tenfoldfleet/instagram-reels-analytics) | reel |
| [Instagram Reels Search - Keyword to Top Reels, Plays & Creators](https://apify.com/tenfoldfleet/instagram-reels-search) | reel |
| [Instagram Reels Transcript - Speech to Text for Public Reels](https://apify.com/tenfoldfleet/instagram-reels-transcript) | reel transcript |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/brand-mentions-monitor/changelog.md

# Actor input Schema

## `keywords` (type: `array`):

Brand names, product names, competitor names or phrases to watch for, one per line, up to 50 per run. Each keyword is searched on every selected source and every hit is checked in the post text before it is returned.

## `sources` (type: `array`):

Where to look. Bluesky and Hacker News are searched in full text. Mastodon has no public full-text search, so the keyword is turned into a hashtag ("Brand Mentions" becomes #BrandMentions) and that hashtag's timeline is read on the servers below.

## `timeWindow` (type: `string`):

How far back the first run of a monitor searches. Later runs continue from where the previous complete run ended, even when that was longer ago than this window.

## `matchMode` (type: `string`):

"Exact phrase": the keyword's words appear together in this order (case doesn't matter, whole words only). "All words": every word appears somewhere in the post. "Any word": at least one word appears. On Mastodon a post carrying the keyword's hashtag always counts.

## `excludeWords` (type: `array`):

Skip a post when its text contains any of these words or phrases (whole words, case doesn't matter). Skipped posts are never charged. Example: for the brand "Notion" exclude "the notion".

## `languages` (type: `array`):

Keep only posts in these languages, as two-letter codes ("en", "de"). Hacker News posts and posts without a language tag are always kept. Empty: all languages.

## `maxMentionsPerSource` (type: `integer`):

Upper limit of mentions returned for each keyword from each source in one run. Mentions over the limit are skipped for good and not charged. Free Apify plan: at most 50 mentions per run in total.

## `mastodonInstances` (type: `array`):

Mastodon servers whose public hashtag timelines are read, up to 5. mastodon.social is the largest and sees posts from across the network; small servers often return nothing.

## `monitorName` (type: `string`):

Runs with the same monitor name share a memory of the mentions already returned, so each scheduled run returns only what is new. Leave it empty and a saved task keeps its own memory; a run outside a task ties the memory to its exact keyword list. Use a different name for each brand or client.

## `onlyNewMentions` (type: `boolean`):

On: skip mentions this monitor returned in earlier runs (the first run returns the backlog in the time window). Off: return every match in the time window on every run; each returned mention is charged.

## `proxyConfiguration` (type: `object`):

Not needed: all three sources are public APIs. Turn on the Apify datacenter proxy only if a source blocks your runs. Residential proxy groups are ignored.

## Actor input object example

```json
{
  "keywords": [
    "Shopify",
    "Cloudflare"
  ],
  "sources": [
    "bluesky",
    "hackernews",
    "mastodon"
  ],
  "timeWindow": "week",
  "matchMode": "phrase",
  "maxMentionsPerSource": 20,
  "mastodonInstances": [
    "mastodon.social"
  ],
  "onlyNewMentions": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "Shopify",
        "Cloudflare"
    ],
    "maxMentionsPerSource": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/brand-mentions-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "Shopify",
        "Cloudflare",
    ],
    "maxMentionsPerSource": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/brand-mentions-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "Shopify",
    "Cloudflare"
  ],
  "maxMentionsPerSource": 20
}' |
apify call tenfoldfleet/brand-mentions-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/brand-mentions-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AMHWZabWqF17K73rf/builds/YwAerKCcO8E4GdyZi/openapi.json
