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

---

# Mastodon Hashtag Timeline API

Posts with one hashtag on one server, filtered by scope, media and the other tags they carry.

`GET /v1/mastodon/timelines/hashtags/photography?host=mastodon.social` returns `data.posts` for the tag, newest first. `scope=all` (the default) is everything the server has seen, `local` keeps its own accounts and `remote` keeps accounts from other servers. `mediaOnly=true` keeps posts with an attachment. `any`, `all` and `none` take up to four comma-separated tags: match any, require all, or exclude.

A post reaches a server through its users' follows, so the same tag gives different posts on different servers. `data.tag` repeats the tag, and `data.declaredAccess` is filled when the operator closed the feed, with the `local` and `remote` settings (`public`, `authenticated` or `disabled`). Follow `page.nextCursor` while `page.hasMore` is true; `limit` accepts 1 to 40 and defaults to 20.

## Request

- **Endpoint:** `GET /v1/mastodon/timelines/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/timelines/hashtags/tag/get)
- **Platform page:** [/platforms/mastodon](https://www.socialfetch.dev/platforms/mastodon)

## FAQ

### Why does the same hashtag differ between servers?

A server only holds posts its users have seen through follows and boosts. Two servers can return different posts for one tag, so pick the server whose community you care about.

### 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 any, all and none work?

Send comma-separated tags. any keeps a post with at least one of them, all requires every one, and none excludes a post with any. Each list accepts up to four tags, and they can be combined.

### Why is the timeline restricted?

The operator closed hashtag timelines to the public. reason.code says whether a login is required or the operator disabled it, and declaredAccess shows the setting for local and remote feeds.

### Can I page through old posts?

Pass page.nextCursor from the previous response while page.hasMore is true. limit accepts 1 to 40; each page is a separate billed request.