datagrit › Data › Bluesky Community Finder: Starter Packs & Feeds

Bluesky Community Finder: Starter Packs & Feeds

Find Bluesky starter packs, custom feeds and curated lists by topic, with join counts, feed likes and full member lists with follower counts.

Bluesky Community Finder builds a catalog of the communities on Bluesky: starter packs, custom feeds and curated lists. Search by topic or point it at specific accounts, and every starter pack, feed or list comes back as one clean row with its creator, dates, size and popularity. Starter packs carry all-time and weekly join counts and the member count. Feeds carry likes and, if you ask for it, a live check of whether the feed is still online and valid. Lists carry their purpose (curate, moderation or reference) and member count. Turn on members and every pack or list is followed by one row per account, with followers, follows, posts and verification status. It reads Bluesky's public API, needs no login or API key, and exports to JSON, CSV or Excel.

Who is it for?

• Community managers and marketers looking for the starter packs and feeds that already gather an audience around a topic, and for the people inside them.
• Creators and publishers checking where their niche lives on Bluesky and which packs are still gaining joins.
• Researchers and analysts mapping topic communities, comparing how many people join packs and like feeds.
• Developers and data teams who need a scheduled, deduplicated feed of new packs, feeds and lists for a dashboard or an alert.

Pricing

You pay per result row: each starter pack, feed, list or member returned is one result, and the price per result is set on the Actor page and shown before you run it. The free example with empty input is not charged. There are no charges for rows that were filtered out or skipped as already seen, and a search that finds nothing returns a single status row with found: false that is not billed. Set a maximum charge per run in the Apify console to cap spending; the Actor stops cleanly when it is reached.

How to use it

1. Choose what to find: starter packs, custom feeds, or lists.
2. Add search terms (for example journalists or science) or account handles such as bsky.app. Starter packs and feeds can be searched by topic. Lists cannot be searched by topic, so use handles for them.
3. Narrow the results with the filters below, and switch on members if you want the accounts inside each pack or list.
4. Set the maximum number of communities and run the Actor.

If you leave search terms and handles empty, the Actor runs a small free example (up to 10 results, not charged) so you can see the output before you configure anything; the status message says so.

Filters

• Name or description contains: keep results matching any of your words.
• Minimum joins (starter packs): people who joined through the pack, all time.
• Minimum members (starter packs and lists): accounts inside the community.
• Minimum likes (feeds).
• Created after: packs use their creation date, feeds and lists the date Bluesky indexed them.
• List type (lists): curate, moderation or reference.
• Check feed health and Only feeds that are online (feeds): one extra request per feed to confirm it still answers and returns valid posts.
• Only communities not seen before: skip anything an earlier run with the same search terms, handles and filters already returned, so a scheduled run delivers only new packs and feeds.

A filter that does not apply to the chosen type is listed in the status message instead of failing silently.

Members

With Include members, each starter pack or list is followed by up to your chosen number of member rows. Add follower counts to members looks up followers, follows, posts and verification for every member. Member rows are separate results and are billed like any other row; the limit on communities does not cap them, so set the maximum members per community to match your budget.

Good to know

• Bluesky's public API returns member counts for starter packs only from the detail of each pack, so the Actor makes one extra request per pack. Feeds and lists carry their counts in the listing.
• The status message at the end of every run reports how many member counts, feed health checks and member profiles were actually retrieved. If Bluesky stops returning one of them for every record, the run fails instead of filling the field with zeros. Member lists that Bluesky no longer serves are skipped and counted (Member lists unavailable), and the run fails only when none can be read; the same applies to listing fields such as join, like and member counts and to member records in an unexpected shape.
• Accounts that were deactivated after being added to a list keep their member row, with follower counts set to null.
• Only public data is read. Private accounts, direct messages and anything behind a login are out of reach.

Output fields

Every result is one flat record, so it drops straight into a spreadsheet, a database or a CRM.

Sample record

{
  "type": "starterPack",
  "query": "journalists",
  "uri": "at://did:plc:ab12cd34ef56/app.bsky.graph.starterpack/3kabcdefgh2",
  "url": "https://bsky.app/starter-pack/example.bsky.social/3kabcdefgh2",
  "name": "Bluesky for Journalists",
  "description": "Journalists worth following on Bluesky.",
  "creatorHandle": "example.bsky.social",
  "creatorDisplayName": "Example Creator",
  "creatorDid": "did:plc:ab12cd34ef56",
  "createdAt": "2024-06-25T05:30:27.442Z",
  "updatedAt": "2024-07-01T10:00:00.000Z",
  "indexedAt": "2024-06-25T05:30:28.000Z",
  "joinedAllTimeCount": 37,
  "joinedWeekCount": 2,
  "memberCount": 150,
  "feedCount": 3,
  "feedUris": [
    "at://did:plc:ab12cd34ef56/app.bsky.feed.generator/news"
  ],
  "likeCount": 23983,
  "acceptsInteractions": true,
  "contentMode": "unspecified",
  "serviceDid": "did:web:feed.example.com",
  "isOnline": true,
  "isValid": true,
  "purpose": "curate",
  "communityType": "starterPack",
  "communityUri": "at://did:plc:ab12cd34ef56/app.bsky.graph.starterpack/3kabcdefgh2",
  "communityName": "Bluesky for Journalists",
  "did": "did:plc:zz99yy88xx77",
  "handle": "reporter.bsky.social",
  "displayName": "Example Reporter",
  "accountCreatedAt": "2023-05-01T12:00:00.000Z",
  "followersCount": 1200,
  "followsCount": 340,
  "postsCount": 5600,
  "isVerified": false,
  "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:zz99yy88xx77/abc@jpeg",
  "scrapedAt": "2026-10-01T08:00:00.000Z",
  "found": true
}

Input

Call it from your code

Run the Actor and get the results in one request. Replace YOUR_APIFY_TOKEN with the token from your Apify account settings.

curl -X POST "https://api.apify.com/v2/acts/datagrit~bluesky-community-finder/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"starterPacks","queries":["journalists","science"],"maxItems":30}'

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('datagrit/bluesky-community-finder').call({
  "mode": "starterPacks",
  "queries": [
    "journalists",
    "science"
  ],
  "maxItems": 30
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("datagrit/bluesky-community-finder").call(run_input={
  "mode": "starterPacks",
  "queries": [
    "journalists",
    "science"
  ],
  "maxItems": 30
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(len(items), items[0] if items else None)

Frequently asked questions

Related Actors