Social Fetch
Start for freeStart free
Mastodon hub

Mastodon Reactions API

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

GET /v1/mastodon/posts/reactions

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

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

Other Mastodon endpoints