Bluesky Mentions Monitor: Keyword Alerts to Slack

Watch public Bluesky posts for keywords, brand names, competitor names, domains, @-mentions of an account, or new posts from accounts you follow. One dataset row per post. Turn on monitoring and each run returns only the posts that are new since the last run, and can push them straight to Slack, Discord or Telegram.

No API key. Anonymous public search on api.bsky.app.

How to use Bluesky Mentions Monitor: Keyword Alerts to Slack

1. In the Apify Console. Open the actor page and click Start — the queries field is already pre-filled with a working example. Results land in the run's dataset as soon as each item is found.
2. Via the API. Call it directly with a POST request — no Console needed once you have an API token:

   curl "https://api.apify.com/v2/acts/accountable_eel~bluesky-mentions-monitor/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
     -X POST \
     -H "Content-Type: application/json" \
     -d '{"queries":["apify"]}'
   

3. On a schedule. Save this actor as an Apify Task with the input you want, then add a Schedule (hourly, daily, weekly) so it runs on its own — no server of your own required.

Input

{
  "queries": [
    "apify"
  ]
}

One search per line: a keyword, a phrase in quotes, or a bare domain such as apify.com. Each line is searched across public Bluesky posts. Mentions and watched accounts are set in their own fields below. Accepted formats: apify, "open source", apify.com.

• queries: keywords, phrases in quotes, or bare domains. One search each.
• mentionHandles (optional): handles whose @-mentions to watch.
• watchHandles (optional): handles whose own new posts to return (reposts excluded).
• sinceHours (default 24, max 720), maxResults (default 100, max 1,000, per item).
• language, excludeReplies, minLikes: filters applied before billing.
• onlyNewSinceLastRun and deltaName: monitoring and watchlist name.
• notifyUrl and notifyFormat: Slack, Discord or Telegram webhook (or any JSON endpoint). The link is a secret and is never logged.

Output

query	found	status	postUrl	text	authorHandle	authorDisplayName	createdAt	likeCount	repostCount	replyCount	matchedQuery	isNew	firstSeenAt	scrapedAt
apify	true	OK										<is this post new?>		1970-01-01T00:00:00.000Z

One row per post: postUrl, text, authorHandle, authorDisplayName, createdAt, likeCount, repostCount, replyCount, quoteCount, lang, links, hashtags, matchedQuery, isNew, firstSeenAt, uri. Counts are null when Bluesky does not return them. A search with no matches returns one found: false row and costs nothing.

Billing

One post event per post returned. A search with no matches, and a monitoring run with nothing new, are never charged.

Tests

npm test runs offline tests against a saved search-page fixture.