Short answer: Bluesky doesn't have an "export followers" button, but follower lists are public through Bluesky's API. The free Python script below downloads any account's followers or following list to a CSV file you can open in Excel, Numbers or Google Sheets. It needs no login, no app password and no extra packages – just Python 3.
We tested it on November 13, 2026: exporting an account with about 1,300 followers, including each follower's own follower counts, took under a minute.
What You Get
One row per follower, with these columns:
| Column | Example |
|---|---|
handle | jane.bsky.social |
displayName | Jane Smith |
did | did:plc:… (permanent account ID) |
createdAt | When their account was created |
description | Their bio |
followersCount, followsCount, postsCount | With --counts only |
With follower counts included, you can sort the spreadsheet to find your most influential followers – useful for creators, brands and anyone planning outreach.
The Script
Save this as export_followers.py:
import csv
import json
import sys
import time
import urllib.parse
import urllib.request
API = "https://public.api.bsky.app/xrpc/"
def get(method, params):
url = API + method + "?" + urllib.parse.urlencode(params, doseq=True)
req = urllib.request.Request(url, headers={"User-Agent": "follower-export"})
for attempt in range(5):
try:
with urllib.request.urlopen(req) as resp:
return json.load(resp)
except urllib.error.HTTPError as e:
if e.code == 429 or e.code >= 500:
time.sleep(2 ** attempt) # back off and retry
continue
raise
raise RuntimeError(f"Gave up on {method}")
def fetch_all(method, key, actor):
people, cursor = [], None
while True:
params = {"actor": actor, "limit": 100}
if cursor:
params["cursor"] = cursor
page = get(method, params)
people.extend(page[key])
print(f" {len(people)} fetched...", file=sys.stderr)
cursor = page.get("cursor")
if not cursor or not page[key]:
return people
def add_counts(people):
# getProfiles returns follower/following/post counts, 25 accounts per call
by_did = {}
for i in range(0, len(people), 25):
batch = [p["did"] for p in people[i:i + 25]]
for prof in get("app.bsky.actor.getProfiles", {"actors": batch})["profiles"]:
by_did[prof["did"]] = prof
for p in people:
prof = by_did.get(p["did"], {})
p["followersCount"] = prof.get("followersCount", "")
p["followsCount"] = prof.get("followsCount", "")
p["postsCount"] = prof.get("postsCount", "")
def main():
if len(sys.argv) < 2:
sys.exit("Usage: python3 export_followers.py HANDLE [followers|following] [--counts]")
actor = sys.argv[1].lstrip("@")
mode = "following" if "following" in sys.argv[2:] else "followers"
method, key = {
"followers": ("app.bsky.graph.getFollowers", "followers"),
"following": ("app.bsky.graph.getFollows", "follows"),
}[mode]
print(f"Fetching {mode} for {actor}", file=sys.stderr)
people = fetch_all(method, key, actor)
fields = ["handle", "displayName", "did", "createdAt", "description"]
if "--counts" in sys.argv:
add_counts(people)
fields += ["followersCount", "followsCount", "postsCount"]
out = f"{actor}-{mode}.csv"
with open(out, "w", newline="", encoding="utf-8") as f:
writer = csv.DictWriter(f, fieldnames=fields, extrasaction="ignore")
writer.writeheader()
for p in people:
writer.writerow({k: ("" if p.get(k) is None else p[k]) for k in fields})
print(f"Saved {len(people)} rows to {out}", file=sys.stderr)
if __name__ == "__main__":
main()
How to Run It
Export your followers
python3 export_followers.py yourname.bsky.social
This creates yourname.bsky.social-followers.csv in the same folder.
Export who you follow
python3 export_followers.py yourname.bsky.social following
Include follower counts for every follower
python3 export_followers.py yourname.bsky.social --counts
This makes one extra request per 25 people, so it takes a little longer on big accounts.
It works for any public account, not just yours – follower lists on Bluesky are public. Replace the handle with any other, including custom-domain handles like example.com.
How It Works
app.bsky.graph.getFollowersreturns followers 100 at a time with acursorfor the next page. The script loops until there's no cursor left.app.bsky.graph.getFollowsdoes the same for the following list.app.bsky.actor.getProfilesfetches full profiles, including counts, for up to 25 accounts per call.- Both are called on
public.api.bsky.app, Bluesky's public, unauthenticated API. That's why no login is needed. - If Bluesky returns a 429 (rate limited) or a server error, the script waits and retries with exponential backoff. For a deeper treatment, see our 429 retry guide.
Why the Export Has Fewer Rows Than Your Follower Count
This surprises almost everyone. In our test, the profile said 1,279 followers and the export returned 1,090 rows. That's expected:
- The follower count on a profile counts every follow record pointing at you.
- The follower list leaves out accounts that are deactivated, suspended, deleted or otherwise hidden from you.
Accounts that have left or been removed still count toward the number but can't be listed. The gap is usually bigger for older accounts and for accounts that attract spam followers, which tend to get removed.
What You Can Do With the CSV
- Find your biggest followers: sort by
followersCount. - Find who doesn't follow you back: export both lists and compare the
didcolumns. A spreadsheetCOUNTIForVLOOKUPworks. Or see how to see who unfollowed you on Bluesky. - Spot bots: new accounts with no posts and thousands of follows stand out once you sort.
- Build a list: pick the best accounts and add them to a Bluesky list or a starter pack.
- Keep a backup of your social graph alongside your account backup.
Troubleshooting
HTTP Error 400: Bad Request: Bluesky couldn't find that account ("Actor not found"). Check the spelling of the handle. A leading @ is fine – the script strips it.- Empty CSV: the account has no visible followers yet, or every follower has since been deactivated or removed.
- Garbled characters in Excel: the file is UTF-8. In Excel, use Data → From Text/CSV and choose UTF-8, or open it in Google Sheets or Numbers.
python3: command not foundon Windows: usepy export_followers.py …instead.
Frequently Asked Questions
Can I export my Bluesky followers?
Yes. Bluesky has no export button, but follower lists are public through its API. A short script can download them to a CSV file without logging in.
Do I need to log in or create an app password?
No. Follower and following lists are available from Bluesky's public API at public.api.bsky.app, which doesn't require authentication.
Can I export someone else's Bluesky followers?
Yes. Follower and following lists are public on Bluesky, so the same script works for any public account.
Why does my export have fewer followers than my profile shows?
The profile count includes follows from accounts that are deactivated, suspended or deleted. Those accounts can't be listed, so the export is lower.
Can I export my Bluesky following list?
Yes. Add "following" after the handle when you run the script, and it uses app.bsky.graph.getFollows instead.
More Bluesky Tools
- Bluesky Tools – account backups, keyword alerts and more
- Trending Hashtags – live hashtag trends, plus an API
- Skyscraper for iOS – a better Bluesky and Mastodon client