List Mastodon profile followers
List the accounts that follow a Mastodon profile.
Headers
Get your API keyAPI key (`sfk_...`)
Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 512 chars
Items per page, 1 to 80. Default: 40.
≥ 1 · ≤ 80
Endpoint-specific response payload.
`found`, `not_found`, `restricted` (login required or closed), `unsupported` (this server does not offer it) or `not_compatible` (the host is not a Mastodon-compatible server). See `reason`.
one of: found, not_found, restricted, unsupported, not_compatible
The server that was asked.
Only on a `not_compatible` result (and always on the server endpoint): the software the host runs, from its NodeInfo, e.g. `misskey` or `lemmy`; null when it does not say. Absent otherwise.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: login_required, closed_by_operator, hidden_by_owner, suspended, not_implemented, disabled_by_operator, not_a_mastodon_server, unsupported_server_software, host_not_found, post_not_visible
Plain-language explanation.
The account, when the server returned it.
Account id on `host`.
The server this record came from.
`user@host`, with the account's home server.
Profile page.
Display name.
True when the owner hides the list (`hide_collections`). The list is then empty although the counts are not.
Accounts following this profile, newest first.
Account id on `host`.
The server this record came from.
`user@host`, with the account's home server.
Username without the host.
Profile page.
ActivityPub id, when the server shows it.
Display name.
Bio as sanitised HTML.
Bio as plain text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
Account creation, rounded to midnight UTC by the server.
Date of the latest post (a date, not a time).
The server's own counters.
Accounts following this account.
Accounts this account follows.
Posts by this account.
True when the account is marked as a bot.
True when the account is a group.
Follow requests need approval. Public posts are still public.
The server's moderators limited (silenced) the account.
True when the server suspended the account.
The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.
The owner's opt-in to search engines indexing public posts. null when not reported.
The owner asks search engines to skip the profile. null when not reported.
The owner hides the follower and following lists. null when not reported.
The account this one moved to.
Account id on the server that returned it.
`user@host` of the account this one moved to.
Profile page of the new account.
Display name of the new account.
Profile metadata fields, in the owner's order.
Label.
Value as sanitised HTML.
Value as plain text.
When a link in the value was verified with rel=me.
Custom emojis used in the display name or bio.
Shortcode without colons.
Emoji image.
Still frame.
Public badges such as Owner or Moderator.
Role id on `host`.
Role name, such as Owner or Moderator.
Badge colour as a hex value, when set.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social/followers" \
-H "x-api-key: YOUR_API_KEY"Responses
The account's followers, or that the owner hides them.