Bluesky Brand Monitor — Mentions, Keywords & Hashtags

What does Bluesky Brand Monitor do?

Bluesky Brand Monitor scrapes public posts, profiles, and threads from Bluesky (bsky.app). Use it as a Bluesky API alternative for brand mention monitoring, keyword search, hashtag tracking, and account activity — without a browser.

Collect structured JSON for social listening, competitor research, influencer analysis, and RAG / LLM datasets.

Why scrape Bluesky?

Bluesky is growing fast for tech, media, and brand conversations. This Actor helps you:

• Track brand mentions and competitor keywords in real time
• Build a deduped mention feed across keywords, hashtags, and handles in one run
• Use delta mode (onlyNewPosts) so scheduled runs return only new posts
• Get an alert summary with top posts by engagement and spike detection vs the previous run
• Monitor public handles and post threads (no login required)
• Search posts by keyword or hashtag (free Bluesky app password)
• Filter by author, domain, mentions, language, and date range

Run on a schedule, call it from the Apify API, or connect it to AI agents via Apify MCP.

What data can Bluesky Brand Monitor extract?

Field	Description
text	Post content
url	Public Bluesky post URL
createdAt	Post timestamp
likeCount / repostCount / replyCount / quoteCount	Engagement metrics
engagementTotal	Sum of engagement counts
authorHandle / authorDisplayName	Author identity
authorFollowers / authorBio	Profile stats (when enrichment is on)
hashtags / mentions / urls	Entities in the post
mediaUrls	Image, video, or link embeds
sourceType / sourceQuery	How the post was found (merged when it matches multiple sources)

Key-value store also includes author profiles, an alert summary (top posts, spikes), and delta state when onlyNewPosts is enabled.

How to scrape Bluesky posts

1. Open this Actor in Apify Console.
2. Choose a mode:
   • Handles — recent posts from public accounts (no login)
   • Post URLs — a post and its reply thread (no login)
   • Keywords / hashtags — search public posts (requires a free Bluesky app password)
3. Set maxResults (and optional filters like since, authorFilter, or domainFilter).
4. Click Start and download results as JSON, CSV, Excel, or HTML.

Example: monitor an account (no login)

{
  "handles": ["bsky.app"],
  "maxResults": 50
}

Example: brand keyword search

Create an app password at bsky.app → Settings → App Passwords, then:

{
  "searchQueries": ["your brand", "competitor"],
  "hashtags": ["yourbrand"],
  "since": "2026-01-01",
  "sort": "latest",
  "blueskyHandle": "yourname.bsky.social",
  "blueskyAppPassword": "xxxx-xxxx-xxxx-xxxx",
  "maxResults": 100
}

Example: scheduled brand monitoring (only new posts)

{
  "searchQueries": ["your brand"],
  "hashtags": ["yourbrand"],
  "handles": ["competitor.bsky.social"],
  "onlyNewPosts": true,
  "topPostsLimit": 5,
  "blueskyHandle": "yourname.bsky.social",
  "blueskyAppPassword": "xxxx-xxxx-xxxx-xxxx",
  "maxResults": 50
}

Schedule this in Apify Console. Each run returns only posts not seen before, plus a summary record with topPosts, isSpike, and engagement deltas for alerts.

How much does it cost to scrape Bluesky?

This Actor uses pay-per-event billing: you pay for posts collected, not for idle browser time. It uses the official AT Protocol HTTP APIs (no browser), so runs stay fast and compute-light.

Configure pricing in Apify Console when you publish or run the Actor. Apify free-tier credits are enough to try small runs.

Input

See the Input tab for the full form. Main options:

Field	Description
handles	Bluesky accounts to monitor (default: bsky.app)
searchQueries	Keywords to search (needs app password)
hashtags	Hashtags without # (needs app password)
postUrls	Post URLs to fetch with reply threads
maxResults	Max posts per source (default: 50)
maxTotalResults	Cap across all sources (default: 5000)
authorFilter / domainFilter / mentionsFilter	Narrow search results
since / until	Date range for search
enrichAuthorProfiles	Attach follower counts and bio to posts
onlyNewPosts	Delta mode: only posts not seen in previous runs
topPostsLimit	Highest-engagement posts in the alert summary
spikeThreshold	Multiplier vs previous run to flag isSpike
blueskyHandle / blueskyAppPassword	Required only for keyword and hashtag search

Output

Results go to the default dataset. Download as JSON, CSV, Excel, or HTML.

{
  "type": "post",
  "url": "https://bsky.app/profile/bsky.app/post/3mpok7nkjtc2o",
  "text": "Post content...",
  "createdAt": "2026-07-02T17:21:51.498Z",
  "likeCount": 1200,
  "repostCount": 340,
  "replyCount": 89,
  "quoteCount": 18,
  "engagementTotal": 1647,
  "authorHandle": "bsky.app",
  "authorFollowers": 850000,
  "hashtags": ["opensource"],
  "sourceType": "handle",
  "sourceQuery": "bsky.app"
}

Key-value store records:

• summary — alert payload: topPosts, isSpike, postDelta, engagementChangePct, errors
• deltaState — seen post IDs when onlyNewPosts is enabled
• profiles — author profiles when includeProfiles is enabled

Tips for better Bluesky brand monitoring

• Enable onlyNewPosts on schedules so you only pay for and alert on new mentions.
• Combine keywords, hashtags, and handles in one run — duplicates are merged into a single mention feed with multi-source attribution.
• Read summary.isSpike and summary.topPosts for Slack/email alerts or agent workflows.
• Use handles or post URLs when you only need public feeds — no credentials required.
• Combine searchQueries with domainFilter or mentionsFilter for tighter brand filters.
• Lower maxResults and turn off enrichAuthorProfiles for cheaper, faster runs.

FAQ

Do I need a Bluesky account?

Only for keyword and hashtag search. Monitoring handles and post threads works on the public API with no login.

Is this a Bluesky API?

It uses Bluesky’s official AT Protocol endpoints (public.api.bsky.app and authenticated search on bsky.social). You get structured post and profile data without building your own client.

Can I use this for social listening and sentiment analysis?

Yes. Export posts with engagement metrics, hashtags, mentions, and author stats, then pipe them into your analytics or LLM pipeline.

How do I run this from code or an AI agent?

Use the API tab in Apify Console for OpenAPI / HTTP access. For AI agents, connect the Actor through Apify MCP and call it as a tool for brand checks (e.g. “any new mentions of X on Bluesky?” with onlyNewPosts: true).

Is it legal to scrape Bluesky?

This Actor only collects public posts and profiles that users have shared on Bluesky. It does not extract private data such as emails or private messages. Results may still include personal data protected by GDPR and similar laws. Only scrape when you have a legitimate purpose, and consult legal counsel if you are unsure.

For bugs or feature requests, use the Issues tab on this Actor’s page.