Social Fetch
Start for freeStart free
Mastodon hub

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Mastodon Followers API 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.

Other Mastodon endpoints