Get Mastodon post
Get a public Mastodon post by its URL: text, media, polls, link card, counts and author.
Headers
Get your API keyAPI key (`sfk_...`)
Public URL of a post, e.g. `https://mastodon.social/@Gargron/117555039933723776`. The server in the URL is the server asked, because post ids belong to a server.
Endpoint-specific response payload.
`found`, `not_found`, `restricted` (login required or closed), `unsupported` (this server does not offer it) or `not_compatible` (the host is not a Mastodon-compatible server). See `reason`.
one of: found, not_found, restricted, unsupported, not_compatible
The server that was asked.
Only on a `not_compatible` result (and always on the server endpoint): the software the host runs, from its NodeInfo, e.g. `misskey` or `lemmy`; null when it does not say. Absent otherwise.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: login_required, closed_by_operator, hidden_by_owner, suspended, not_implemented, disabled_by_operator, not_a_mastodon_server, unsupported_server_software, host_not_found, post_not_visible
Plain-language explanation.
The post when `lookupStatus` is `found`; otherwise null.
Post id on `host`.
The server this record came from.
Post page.
ActivityPub id. Stable across servers.
ISO-8601 UTC.
When the post was last edited, or null.
ISO code, or null when unset.
Post body as sanitised HTML.
Post body as plain text.
Content warning text.
True when the author marked the post sensitive.
`public` or `unlisted`.
The account that wrote the post.
Account id on `host`.
The server this record came from.
`user@host`, with the account's home server.
Username without the host.
Profile page.
ActivityPub id, when the server shows it.
Display name.
Bio as sanitised HTML.
Bio as plain text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
Account creation, rounded to midnight UTC by the server.
Date of the latest post (a date, not a time).
The server's own counters.
Accounts following this account.
Accounts this account follows.
Posts by this account.
True when the account is marked as a bot.
True when the account is a group.
Follow requests need approval. Public posts are still public.
The server's moderators limited (silenced) the account.
True when the server suspended the account.
The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.
The owner's opt-in to search engines indexing public posts. null when not reported.
The owner asks search engines to skip the profile. null when not reported.
The owner hides the follower and following lists. null when not reported.
The account this one moved to.
Account id on the server that returned it.
`user@host` of the account this one moved to.
Profile page of the new account.
Display name of the new account.
Profile metadata fields, in the owner's order.
Label.
Value as sanitised HTML.
Value as plain text.
When a link in the value was verified with rel=me.
Custom emojis used in the display name or bio.
Shortcode without colons.
Emoji image.
Still frame.
Public badges such as Owner or Moderator.
Role id on `host`.
Role name, such as Owner or Moderator.
Badge colour as a hex value, when set.
The post this replies to. Ids belong to `host`.
Id of the post this one replies to, on `host`.
Id of the account this post replies to, on `host`.
Engagement counters as the server reports them.
Replies the server counts.
Boosts the server counts.
Favourites the server counts.
Quotes the server counts, when it reports them.
Media attached to the post.
Media id on `host`.
`image`, `video`, `gifv` or `audio`.
one of: image, video, gifv, audio, unknown
File on the author's server. Never copied.
Preview image.
Where the file lives on the author's own server.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Duration in seconds for video or audio, when known.
Focal point, -1 to 1.
Horizontal focal point, -1 to 1.
Vertical focal point, -1 to 1.
Hashtags in the post.
Hashtag name without the `#`.
Hashtag page on the server.
Accounts mentioned in the post.
Account id on `host`.
`user@host` of the mentioned account.
Username without the host.
Profile page of the mentioned account.
Custom emojis used in the post.
Shortcode without colons.
Emoji image.
Still frame.
Link preview card, when the post has one.
The link the card points to.
Title of the linked page.
Short description of the linked page.
`link`, `photo`, `video` or `rich`.
Site that published the linked page.
The publisher's own page.
Authors of the linked page.
Author name.
Author page.
When the linked page was published, when known.
ISO language code of the linked page, when known.
Preview image, when the link has one.
Preview image.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Poll, when the post has one.
Poll id on `host`.
When voting closes, when the poll has an end.
True when voting has closed.
True when a voter may choose more than one option.
Total votes, or null when the server does not report it.
Distinct voters, or null when the server does not count them.
Poll choices, in the author's order.
Option text.
Votes for this option, when reported.
Custom emojis used in the poll.
Shortcode without colons.
Emoji image.
Still frame.
The client the author posted from.
Name of the client.
The client's website.
True when this is a boost of another post.
The boosted post when `isBoost` is true.
Post id on `host`.
The server this record came from.
Post page.
ActivityPub id. Stable across servers.
ISO-8601 UTC.
When the post was last edited, or null.
ISO code, or null when unset.
Post body as sanitised HTML.
Post body as plain text.
Content warning text.
True when the author marked the post sensitive.
`public` or `unlisted`.
The account that wrote the post.
Account id on `host`.
The server this record came from.
`user@host`, with the account's home server.
Username without the host.
Profile page.
ActivityPub id, when the server shows it.
Display name.
Bio as sanitised HTML.
Bio as plain text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
Account creation, rounded to midnight UTC by the server.
Date of the latest post (a date, not a time).
The server's own counters.
Accounts following this account.
Accounts this account follows.
Posts by this account.
True when the account is marked as a bot.
True when the account is a group.
Follow requests need approval. Public posts are still public.
The server's moderators limited (silenced) the account.
True when the server suspended the account.
The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.
The owner's opt-in to search engines indexing public posts. null when not reported.
The owner asks search engines to skip the profile. null when not reported.
The owner hides the follower and following lists. null when not reported.
The account this one moved to.
Account id on the server that returned it.
`user@host` of the account this one moved to.
Profile page of the new account.
Display name of the new account.
Profile metadata fields, in the owner's order.
Label.
Value as sanitised HTML.
Value as plain text.
When a link in the value was verified with rel=me.
Custom emojis used in the display name or bio.
Shortcode without colons.
Emoji image.
Still frame.
Public badges such as Owner or Moderator.
Role id on `host`.
Role name, such as Owner or Moderator.
Badge colour as a hex value, when set.
The post this replies to. Ids belong to `host`.
Id of the post this one replies to, on `host`.
Id of the account this post replies to, on `host`.
Engagement counters as the server reports them.
Replies the server counts.
Boosts the server counts.
Favourites the server counts.
Quotes the server counts, when it reports them.
Media attached to the post.
Media id on `host`.
`image`, `video`, `gifv` or `audio`.
one of: image, video, gifv, audio, unknown
File on the author's server. Never copied.
Preview image.
Where the file lives on the author's own server.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Duration in seconds for video or audio, when known.
Focal point, -1 to 1.
Horizontal focal point, -1 to 1.
Vertical focal point, -1 to 1.
Hashtags in the post.
Hashtag name without the `#`.
Hashtag page on the server.
Accounts mentioned in the post.
Account id on `host`.
`user@host` of the mentioned account.
Username without the host.
Profile page of the mentioned account.
Custom emojis used in the post.
Shortcode without colons.
Emoji image.
Still frame.
Link preview card, when the post has one.
The link the card points to.
Title of the linked page.
Short description of the linked page.
`link`, `photo`, `video` or `rich`.
Site that published the linked page.
The publisher's own page.
Authors of the linked page.
Author name.
Author page.
When the linked page was published, when known.
ISO language code of the linked page, when known.
Preview image, when the link has one.
Preview image.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Poll, when the post has one.
Poll id on `host`.
When voting closes, when the poll has an end.
True when voting has closed.
True when a voter may choose more than one option.
Total votes, or null when the server does not report it.
Distinct voters, or null when the server does not count them.
Poll choices, in the author's order.
Option text.
Votes for this option, when reported.
Custom emojis used in the poll.
Shortcode without colons.
Emoji image.
Still frame.
The client the author posted from.
Name of the client.
The client's website.
The quoted post, on servers that support quotes.
`accepted`, `pending`, `deleted`...
The quoted post, when it is public.
Post id on `host`.
The server this record came from.
Post page.
ActivityPub id. Stable across servers.
ISO-8601 UTC.
When the post was last edited, or null.
ISO code, or null when unset.
Post body as sanitised HTML.
Post body as plain text.
Content warning text.
True when the author marked the post sensitive.
`public` or `unlisted`.
The account that wrote the post.
Account id on `host`.
The server this record came from.
`user@host`, with the account's home server.
Username without the host.
Profile page.
ActivityPub id, when the server shows it.
Display name.
Bio as sanitised HTML.
Bio as plain text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
An avatar or header image.
Image URL on the server or its media store.
Still frame of an animated image.
Alt text.
Account creation, rounded to midnight UTC by the server.
Date of the latest post (a date, not a time).
The server's own counters.
Accounts following this account.
Accounts this account follows.
Posts by this account.
True when the account is marked as a bot.
True when the account is a group.
Follow requests need approval. Public posts are still public.
The server's moderators limited (silenced) the account.
True when the server suspended the account.
The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.
The owner's opt-in to search engines indexing public posts. null when not reported.
The owner asks search engines to skip the profile. null when not reported.
The owner hides the follower and following lists. null when not reported.
The account this one moved to.
Account id on the server that returned it.
`user@host` of the account this one moved to.
Profile page of the new account.
Display name of the new account.
Profile metadata fields, in the owner's order.
Label.
Value as sanitised HTML.
Value as plain text.
When a link in the value was verified with rel=me.
Custom emojis used in the display name or bio.
Shortcode without colons.
Emoji image.
Still frame.
Public badges such as Owner or Moderator.
Role id on `host`.
Role name, such as Owner or Moderator.
Badge colour as a hex value, when set.
The post this replies to. Ids belong to `host`.
Id of the post this one replies to, on `host`.
Id of the account this post replies to, on `host`.
Engagement counters as the server reports them.
Replies the server counts.
Boosts the server counts.
Favourites the server counts.
Quotes the server counts, when it reports them.
Media attached to the post.
Media id on `host`.
`image`, `video`, `gifv` or `audio`.
one of: image, video, gifv, audio, unknown
File on the author's server. Never copied.
Preview image.
Where the file lives on the author's own server.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Duration in seconds for video or audio, when known.
Focal point, -1 to 1.
Horizontal focal point, -1 to 1.
Vertical focal point, -1 to 1.
Hashtags in the post.
Hashtag name without the `#`.
Hashtag page on the server.
Accounts mentioned in the post.
Account id on `host`.
`user@host` of the mentioned account.
Username without the host.
Profile page of the mentioned account.
Custom emojis used in the post.
Shortcode without colons.
Emoji image.
Still frame.
Link preview card, when the post has one.
The link the card points to.
Title of the linked page.
Short description of the linked page.
`link`, `photo`, `video` or `rich`.
Site that published the linked page.
The publisher's own page.
Authors of the linked page.
Author name.
Author page.
When the linked page was published, when known.
ISO language code of the linked page, when known.
Preview image, when the link has one.
Preview image.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Poll, when the post has one.
Poll id on `host`.
When voting closes, when the poll has an end.
True when voting has closed.
True when a voter may choose more than one option.
Total votes, or null when the server does not report it.
Distinct voters, or null when the server does not count them.
Poll choices, in the author's order.
Option text.
Votes for this option, when reported.
Custom emojis used in the poll.
Shortcode without colons.
Emoji image.
Still frame.
The client the author posted from.
Name of the client.
The client's website.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/mastodon/posts?url=https://mastodon.social/@Gargron/117555039933723776" \
-H "x-api-key: YOUR_API_KEY"Responses
The post, or why it cannot be shown.