> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/mastodon/profiles-handle-followers>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/mastodon/profiles-handle-followers.mdx>

---

# Mastodon Followers API

Who follows an account on its server, with an explicit signal when the owner hides the list.

`GET /v1/mastodon/profiles/{handle}/followers` resolves the account and returns one page of followers. Each entry in `data.accounts` is a full account record with `id`, `handle`, `displayName`, `bio`, `avatar`, `stats` and the same flags the profile route returns. `data.profile` names the account the list belongs to.

When the owner hides their network, `data.isHidden` is `true` and `accounts` is empty, so you can tell a hidden list from an account with no followers. Follow `page.nextCursor` while `page.hasMore` is true. `limit` accepts 1 to 80 and defaults to 40. The list is the server's view: it includes accounts the server knows about and follows the profile's counters only loosely.

## Request

- **Endpoint:** `GET /v1/mastodon/profiles/{handle}/followers`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/followers/get)
- **Platform page:** [/platforms/mastodon](https://www.socialfetch.dev/platforms/mastodon)

## FAQ

### Why is accounts empty when the profile has followers?

Check data.isHidden. When it is true the owner hides the follower list (hide_collections on Mastodon, hide_followers on Pleroma) and the server returns nothing. An empty list with isHidden false means the account has no followers.

### How many credits does a page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

### How deep can I page?

Pass page.nextCursor from the previous response while page.hasMore is true. limit accepts 1 to 80 and defaults to 40. Each page is a separate request.

### Does the list match the follower counter?

Not necessarily. Servers list the accounts they know, while stats.followers is the account's own counter. Treat the list as a sample of the full follower set, not as the counter.