Social Fetch
Start for freeStart free
Mastodon hub

Mastodon Hashtag API

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

GET /v1/mastodon/hashtags/{tag}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

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

Other Mastodon endpoints