> **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-following>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/mastodon/profiles-handle-following.mdx>

---

# 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` 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.

## Request

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

## 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.