Social Fetch
Start for freeStart free
Mastodon hub

Mastodon Trending Hashtags API

A server's trending tags, each with daily use and account counts, ready to feed a hashtag pull.

GET /v1/mastodon/trends/hashtags

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/mastodon/trends/hashtags?host=mastodon.social returns data.hashtags. Each entry has name, url and history, and each history day has date, uses and accounts, newest first. The numbers are local to that server, so the same tag has different counts elsewhere.

The list is cursor-paged: read data.page.hasMore and pass page.nextCursor as cursor for the next slice. The offset parameter also works. Mastodon orders trends live, so a hashtag can move between requests and appear on two pages; remove repeats by name. limit accepts 1 to 20 and defaults to 20. Take a trending tag from here and pass it to the hashtag timeline or the hashtag usage route. Servers without trends return lookupStatus: unsupported.

Mastodon Trending Hashtags API FAQ

Does history cover the trend or all use?

history is the tag's daily use on that server for the last seven days, not only the posts that made it trend. uses counts posts and accounts counts distinct accounts.

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.

How do I get the posts behind a tag?

Pass the tag name to GET /v1/mastodon/timelines/hashtags/{tag} for posts, or to GET /v1/mastodon/hashtags/{tag} for the same seven-day usage on its own.

Why is the hashtag list empty?

A server that turned trends off returns unsupported. A server that offers trends but has none to show returns found with an empty list.

Other Mastodon endpoints