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

---

# Mastodon Reactions API

Who boosted a post or who favourited it, as account records you can page through.

`GET /v1/mastodon/posts/reactions?url=https://mastodon.social/@Gargron/1&kind=boosts` lists who boosted the post, from the server in the post URL; `kind=favourites` lists who favourited it. `data.kind` repeats the choice, `data.accounts` holds full account records, and `data.page` carries the cursor.

The list is a subset of the post's counters: servers only list accounts they know, so `stats.boosts` and `stats.favourites` on the post can be larger than what this route returns. Follow `page.nextCursor` while `page.hasMore` is true. `limit` accepts 1 to 80 and defaults to 40. A post that is not visible returns `lookupStatus: not_found`.

## Request

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

## FAQ

### What values does kind take?

boosts lists the accounts that boosted the post. favourites lists the accounts that favourited it. The value is required.

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

### Why is the list shorter than the counter?

Servers only list accounts they know about. The post's stats are the author server's counters, while this list is the answering server's view, so it can be shorter.

### How do I page through reactions?

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