Social Fetch
Start for freeStart free
Mastodon hub

Mastodon Following API

Who an account follows on its server, paged with a cursor and flagged when the owner keeps it private.

GET /v1/mastodon/profiles/{handle}/following

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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

When the owner hides their network, data.isHidden is true and accounts is empty. Follow page.nextCursor while page.hasMore is true. limit accepts 1 to 80 and defaults to 40. Accounts on other servers appear with their own home server in handle, while host on each record is the server you named.

Mastodon Following API FAQ

Why is the following list empty?

When data.isHidden is true the owner hides the list and the server returns no accounts. When it is false the account simply follows nobody the server lists.

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.

Are followed accounts from other servers included?

Yes. Their handle keeps their home server, for example someone@fosstodon.org, while host is the server you asked. The server lists the accounts it knows, so the list can be a subset of the profile counter.

How do I page through a long follow list?

Pass page.nextCursor from the previous response while page.hasMore is true. limit accepts 1 to 80; each page is a separate billed request.

Other Mastodon endpoints