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

---

# Mastodon Post API

One post with its author, attachments, poll and link card, from the server in its URL.

`GET /v1/mastodon/posts?url=https://mastodon.social/@Gargron/1` takes a public post URL and returns the post from the server in that URL, because a post id belongs to its server. On `found`, `data.post` carries `id`, `host`, `url`, `uri`, `createdAt`, `editedAt`, `language`, `contentHtml`, `text`, `contentWarning`, `isSensitive`, `visibility`, the full `author`, `replyTo`, `stats`, `media`, `hashtags`, `mentions`, `emojis`, `card`, `poll` and `app`. Boosts set `isBoost` and fill `boostOf`; quotes fill `quote.state` and `quote.post` where the server supports them.

A deleted post, a followers-only post and an id that never existed all come back `lookupStatus: not_found` with `post` null: the server does not distinguish them. The route accepts the common post URL forms, including `/@user/ID`, `/users/user/statuses/ID`, `/web/@user/ID` and Pleroma's `/notice/ID`.

## Request

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

## FAQ

### Which URL forms are accepted?

https://host/@user/ID, https://host/@user@other.host/ID, https://host/users/user/statuses/ID, https://host/web/@user/ID, https://host/web/statuses/ID and Pleroma's https://host/notice/ID. The host in the URL is the server asked.

### How many credits does a post 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 boost return?

The boosting post has isBoost true and the original in boostOf. The top-level author is the account that boosted it; boostOf.author is the original author.

### Why is post null?

lookupStatus not_found covers a deleted post, a followers-only or direct post that is not public, and an id that never existed. restricted means a login is required or the operator closed the route.

### Does it include the reply tree?

No. This route returns one post. Use GET /v1/mastodon/posts/context with the same url for its ancestors and descendants.