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

---

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

## Request

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

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