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

---

# Mastodon Hashtag API

How much a hashtag is used on one server, day by day, before you pull its timeline.

`GET /v1/mastodon/hashtags/photography?host=mastodon.social` returns `data.hashtag` with `name`, `url` and `history`. Each history entry is a day with `date` in `YYYY-MM-DD`, `uses` and `accounts` (the number of distinct accounts that used the tag), newest first, for up to seven days.

Usage is local to the server: the same tag has different numbers on different servers. A valid tag that nobody used returns `found` with zero counts, not `not_found`. A server that does not offer the route returns `unsupported`, and a tag the server rejects returns `not_found`. Use the hashtag timeline route to read the posts themselves.

## Request

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

## FAQ

### How far back does history go?

Up to seven daily entries, newest first. Each entry has date, uses and accounts. The server decides how much it keeps.

### How many credits does a hashtag lookup 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.

### What does a hash mark do?

A leading # is ignored, so #photography and photography are the same request. Names may use letters, digits and underscores and must contain at least one letter.

### Why are all counts zero?

The tag is valid but nobody used it on that server in the window. That is lookupStatus found with zero uses, not a missing tag.