Mastodon

List Mastodon server public timeline

List the public timeline of a Mastodon server.

GET/v1/mastodon/timelines/public
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
hoststringrequiredquery

The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.

scopestringoptionalquery

`all` (default) is everything the server has seen, `local` only the server's own accounts, `remote` only accounts from other servers.

one of: all, local, remote

mediaOnlybooleanoptionalquery

Only posts with media attachments.

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 512 chars

limitintegeroptionalquery

Items per page, 1 to 40. Default: 20.

≥ 1 · ≤ 40

Response fields
419

Endpoint-specific response payload.

datalookupStatus
string

`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

datahost
string

The server that was asked.

datasoftware
stringnullableoptional

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`.

datareasoncode
string

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

datareasonmessage
string

Plain-language explanation.

Filled when the feed is closed: the operator's setting for this feed (Mastodon 4.5 and later), so you can see which switch applies. Otherwise null.

datadeclaredAccesslocal
string

Who may read the local feed.

one of: public, authenticated, disabled

datadeclaredAccessremote
string

Who may read the remote feed.

one of: public, authenticated, disabled

Newest first.

dataposts[]id
string

Post id on `host`.

dataposts[]host
string

The server this record came from.

dataposts[]url
stringnullable

Post page.

dataposts[]uri
stringnullable

ActivityPub id. Stable across servers.

dataposts[]createdAt
stringnullable

ISO-8601 UTC.

dataposts[]editedAt
stringnullable

When the post was last edited, or null.

dataposts[]language
stringnullable

ISO code, or null when unset.

dataposts[]contentHtml
stringnullable

Post body as sanitised HTML.

dataposts[]text
stringnullable

Post body as plain text.

dataposts[]contentWarning
stringnullable

Content warning text.

dataposts[]isSensitive
boolean

True when the author marked the post sensitive.

dataposts[]visibility
stringnullable

`public` or `unlisted`.

The account that wrote the post.

dataposts[]authorid
string

Account id on `host`.

dataposts[]authorhost
string

The server this record came from.

dataposts[]authorhandle
string

`user@host`, with the account's home server.

dataposts[]authorusername
string

Username without the host.

dataposts[]authorurl
stringnullable

Profile page.

dataposts[]authoractorUri
stringnullable

ActivityPub id, when the server shows it.

dataposts[]authordisplayName
stringnullable

Display name.

dataposts[]authorbioHtml
stringnullable

Bio as sanitised HTML.

dataposts[]authorbio
stringnullable

Bio as plain text.

An avatar or header image.

dataposts[]authoravatarurl
stringnullable

Image URL on the server or its media store.

dataposts[]authoravatarstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]authoravatardescription
stringnullable

Alt text.

An avatar or header image.

dataposts[]authorheaderurl
stringnullable

Image URL on the server or its media store.

dataposts[]authorheaderstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]authorheaderdescription
stringnullable

Alt text.

dataposts[]authorcreatedAt
stringnullable

Account creation, rounded to midnight UTC by the server.

dataposts[]authorlastPostDate
stringnullable

Date of the latest post (a date, not a time).

The server's own counters.

dataposts[]authorstatsfollowers
integernullable

Accounts following this account.

dataposts[]authorstatsfollowing
integernullable

Accounts this account follows.

dataposts[]authorstatsposts
integernullable

Posts by this account.

dataposts[]authorisBot
boolean

True when the account is marked as a bot.

dataposts[]authorisGroup
boolean

True when the account is a group.

dataposts[]authorisLocked
boolean

Follow requests need approval. Public posts are still public.

dataposts[]authorisLimited
boolean

The server's moderators limited (silenced) the account.

dataposts[]authorisSuspended
boolean

True when the server suspended the account.

dataposts[]authorisDiscoverable
booleannullable

The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.

dataposts[]authorisIndexable
booleannullable

The owner's opt-in to search engines indexing public posts. null when not reported.

dataposts[]authornoIndex
booleannullable

The owner asks search engines to skip the profile. null when not reported.

dataposts[]authorhidesNetwork
booleannullable

The owner hides the follower and following lists. null when not reported.

The account this one moved to.

dataposts[]authormovedToid
stringnullable

Account id on the server that returned it.

dataposts[]authormovedTohandle
string

`user@host` of the account this one moved to.

dataposts[]authormovedTourl
stringnullable

Profile page of the new account.

dataposts[]authormovedTodisplayName
stringnullable

Display name of the new account.

Profile metadata fields, in the owner's order.

dataposts[]authorfields[]name
string

Label.

dataposts[]authorfields[]valueHtml
string

Value as sanitised HTML.

dataposts[]authorfields[]value
string

Value as plain text.

dataposts[]authorfields[]verifiedAt
stringnullable

When a link in the value was verified with rel=me.

Custom emojis used in the display name or bio.

dataposts[]authoremojis[]shortcode
string

Shortcode without colons.

dataposts[]authoremojis[]url
stringnullable

Emoji image.

dataposts[]authoremojis[]staticUrl
stringnullable

Still frame.

Public badges such as Owner or Moderator.

dataposts[]authorroles[]id
stringnullable

Role id on `host`.

dataposts[]authorroles[]name
string

Role name, such as Owner or Moderator.

dataposts[]authorroles[]color
stringnullable

Badge colour as a hex value, when set.

The post this replies to. Ids belong to `host`.

dataposts[]replyTopostId
stringnullable

Id of the post this one replies to, on `host`.

dataposts[]replyToaccountId
stringnullable

Id of the account this post replies to, on `host`.

Engagement counters as the server reports them.

dataposts[]statsreplies
integernullable

Replies the server counts.

dataposts[]statsboosts
integernullable

Boosts the server counts.

dataposts[]statsfavourites
integernullable

Favourites the server counts.

dataposts[]statsquotes
integernullable

Quotes the server counts, when it reports them.

Media attached to the post.

dataposts[]media[]id
string

Media id on `host`.

dataposts[]media[]type
string

`image`, `video`, `gifv` or `audio`.

one of: image, video, gifv, audio, unknown

dataposts[]media[]url
stringnullable

File on the author's server. Never copied.

dataposts[]media[]previewUrl
stringnullable

Preview image.

dataposts[]media[]originUrl
stringnullable

Where the file lives on the author's own server.

dataposts[]media[]description
stringnullable

Alt text.

dataposts[]media[]blurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]media[]width
integernullable

Width in pixels, when known.

dataposts[]media[]height
integernullable

Height in pixels, when known.

dataposts[]media[]durationSeconds
numbernullable

Duration in seconds for video or audio, when known.

Focal point, -1 to 1.

dataposts[]media[]focusx
number

Horizontal focal point, -1 to 1.

dataposts[]media[]focusy
number

Vertical focal point, -1 to 1.

Hashtags in the post.

dataposts[]hashtags[]name
string

Hashtag name without the `#`.

dataposts[]hashtags[]url
stringnullable

Hashtag page on the server.

Accounts mentioned in the post.

dataposts[]mentions[]id
string

Account id on `host`.

dataposts[]mentions[]handle
string

`user@host` of the mentioned account.

dataposts[]mentions[]username
string

Username without the host.

dataposts[]mentions[]url
stringnullable

Profile page of the mentioned account.

Custom emojis used in the post.

dataposts[]emojis[]shortcode
string

Shortcode without colons.

dataposts[]emojis[]url
stringnullable

Emoji image.

dataposts[]emojis[]staticUrl
stringnullable

Still frame.

Link preview card, when the post has one.

dataposts[]cardurl
string

The link the card points to.

dataposts[]cardtitle
string

Title of the linked page.

dataposts[]carddescription
stringnullable

Short description of the linked page.

dataposts[]cardtype
stringnullable

`link`, `photo`, `video` or `rich`.

dataposts[]cardproviderName
stringnullable

Site that published the linked page.

dataposts[]cardproviderUrl
stringnullable

The publisher's own page.

Authors of the linked page.

dataposts[]cardauthors[]name
stringnullable

Author name.

dataposts[]cardauthors[]url
stringnullable

Author page.

dataposts[]cardpublishedAt
stringnullable

When the linked page was published, when known.

dataposts[]cardlanguage
stringnullable

ISO language code of the linked page, when known.

Preview image, when the link has one.

dataposts[]cardimageurl
string

Preview image.

dataposts[]cardimagedescription
stringnullable

Alt text.

dataposts[]cardimageblurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]cardimagewidth
integernullable

Width in pixels, when known.

dataposts[]cardimageheight
integernullable

Height in pixels, when known.

Poll, when the post has one.

dataposts[]pollid
string

Poll id on `host`.

dataposts[]pollexpiresAt
stringnullable

When voting closes, when the poll has an end.

dataposts[]pollexpired
boolean

True when voting has closed.

dataposts[]pollmultiple
boolean

True when a voter may choose more than one option.

dataposts[]pollvotes
integernullable

Total votes, or null when the server does not report it.

dataposts[]pollvoters
integernullable

Distinct voters, or null when the server does not count them.

Poll choices, in the author's order.

dataposts[]polloptions[]title
string

Option text.

dataposts[]polloptions[]votes
integernullable

Votes for this option, when reported.

Custom emojis used in the poll.

dataposts[]pollemojis[]shortcode
string

Shortcode without colons.

dataposts[]pollemojis[]url
stringnullable

Emoji image.

dataposts[]pollemojis[]staticUrl
stringnullable

Still frame.

The client the author posted from.

dataposts[]appname
string

Name of the client.

dataposts[]appwebsite
stringnullable

The client's website.

dataposts[]isBoost
boolean

True when this is a boost of another post.

The boosted post when `isBoost` is true.

dataposts[]boostOfid
string

Post id on `host`.

dataposts[]boostOfhost
string

The server this record came from.

dataposts[]boostOfurl
stringnullable

Post page.

dataposts[]boostOfuri
stringnullable

ActivityPub id. Stable across servers.

dataposts[]boostOfcreatedAt
stringnullable

ISO-8601 UTC.

dataposts[]boostOfeditedAt
stringnullable

When the post was last edited, or null.

dataposts[]boostOflanguage
stringnullable

ISO code, or null when unset.

dataposts[]boostOfcontentHtml
stringnullable

Post body as sanitised HTML.

dataposts[]boostOftext
stringnullable

Post body as plain text.

dataposts[]boostOfcontentWarning
stringnullable

Content warning text.

dataposts[]boostOfisSensitive
boolean

True when the author marked the post sensitive.

dataposts[]boostOfvisibility
stringnullable

`public` or `unlisted`.

The account that wrote the post.

dataposts[]boostOfauthorid
string

Account id on `host`.

dataposts[]boostOfauthorhost
string

The server this record came from.

dataposts[]boostOfauthorhandle
string

`user@host`, with the account's home server.

dataposts[]boostOfauthorusername
string

Username without the host.

dataposts[]boostOfauthorurl
stringnullable

Profile page.

dataposts[]boostOfauthoractorUri
stringnullable

ActivityPub id, when the server shows it.

dataposts[]boostOfauthordisplayName
stringnullable

Display name.

dataposts[]boostOfauthorbioHtml
stringnullable

Bio as sanitised HTML.

dataposts[]boostOfauthorbio
stringnullable

Bio as plain text.

An avatar or header image.

dataposts[]boostOfauthoravatarurl
stringnullable

Image URL on the server or its media store.

dataposts[]boostOfauthoravatarstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]boostOfauthoravatardescription
stringnullable

Alt text.

An avatar or header image.

dataposts[]boostOfauthorheaderurl
stringnullable

Image URL on the server or its media store.

dataposts[]boostOfauthorheaderstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]boostOfauthorheaderdescription
stringnullable

Alt text.

dataposts[]boostOfauthorcreatedAt
stringnullable

Account creation, rounded to midnight UTC by the server.

dataposts[]boostOfauthorlastPostDate
stringnullable

Date of the latest post (a date, not a time).

The server's own counters.

dataposts[]boostOfauthorstatsfollowers
integernullable

Accounts following this account.

dataposts[]boostOfauthorstatsfollowing
integernullable

Accounts this account follows.

dataposts[]boostOfauthorstatsposts
integernullable

Posts by this account.

dataposts[]boostOfauthorisBot
boolean

True when the account is marked as a bot.

dataposts[]boostOfauthorisGroup
boolean

True when the account is a group.

dataposts[]boostOfauthorisLocked
boolean

Follow requests need approval. Public posts are still public.

dataposts[]boostOfauthorisLimited
boolean

The server's moderators limited (silenced) the account.

dataposts[]boostOfauthorisSuspended
boolean

True when the server suspended the account.

dataposts[]boostOfauthorisDiscoverable
booleannullable

The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.

dataposts[]boostOfauthorisIndexable
booleannullable

The owner's opt-in to search engines indexing public posts. null when not reported.

dataposts[]boostOfauthornoIndex
booleannullable

The owner asks search engines to skip the profile. null when not reported.

dataposts[]boostOfauthorhidesNetwork
booleannullable

The owner hides the follower and following lists. null when not reported.

The account this one moved to.

dataposts[]boostOfauthormovedToid
stringnullable

Account id on the server that returned it.

dataposts[]boostOfauthormovedTohandle
string

`user@host` of the account this one moved to.

dataposts[]boostOfauthormovedTourl
stringnullable

Profile page of the new account.

dataposts[]boostOfauthormovedTodisplayName
stringnullable

Display name of the new account.

Profile metadata fields, in the owner's order.

dataposts[]boostOfauthorfields[]name
string

Label.

dataposts[]boostOfauthorfields[]valueHtml
string

Value as sanitised HTML.

dataposts[]boostOfauthorfields[]value
string

Value as plain text.

dataposts[]boostOfauthorfields[]verifiedAt
stringnullable

When a link in the value was verified with rel=me.

Custom emojis used in the display name or bio.

dataposts[]boostOfauthoremojis[]shortcode
string

Shortcode without colons.

dataposts[]boostOfauthoremojis[]url
stringnullable

Emoji image.

dataposts[]boostOfauthoremojis[]staticUrl
stringnullable

Still frame.

Public badges such as Owner or Moderator.

dataposts[]boostOfauthorroles[]id
stringnullable

Role id on `host`.

dataposts[]boostOfauthorroles[]name
string

Role name, such as Owner or Moderator.

dataposts[]boostOfauthorroles[]color
stringnullable

Badge colour as a hex value, when set.

The post this replies to. Ids belong to `host`.

dataposts[]boostOfreplyTopostId
stringnullable

Id of the post this one replies to, on `host`.

dataposts[]boostOfreplyToaccountId
stringnullable

Id of the account this post replies to, on `host`.

Engagement counters as the server reports them.

dataposts[]boostOfstatsreplies
integernullable

Replies the server counts.

dataposts[]boostOfstatsboosts
integernullable

Boosts the server counts.

dataposts[]boostOfstatsfavourites
integernullable

Favourites the server counts.

dataposts[]boostOfstatsquotes
integernullable

Quotes the server counts, when it reports them.

Media attached to the post.

dataposts[]boostOfmedia[]id
string

Media id on `host`.

dataposts[]boostOfmedia[]type
string

`image`, `video`, `gifv` or `audio`.

one of: image, video, gifv, audio, unknown

dataposts[]boostOfmedia[]url
stringnullable

File on the author's server. Never copied.

dataposts[]boostOfmedia[]previewUrl
stringnullable

Preview image.

dataposts[]boostOfmedia[]originUrl
stringnullable

Where the file lives on the author's own server.

dataposts[]boostOfmedia[]description
stringnullable

Alt text.

dataposts[]boostOfmedia[]blurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]boostOfmedia[]width
integernullable

Width in pixels, when known.

dataposts[]boostOfmedia[]height
integernullable

Height in pixels, when known.

dataposts[]boostOfmedia[]durationSeconds
numbernullable

Duration in seconds for video or audio, when known.

Focal point, -1 to 1.

dataposts[]boostOfmedia[]focusx
number

Horizontal focal point, -1 to 1.

dataposts[]boostOfmedia[]focusy
number

Vertical focal point, -1 to 1.

Hashtags in the post.

dataposts[]boostOfhashtags[]name
string

Hashtag name without the `#`.

dataposts[]boostOfhashtags[]url
stringnullable

Hashtag page on the server.

Accounts mentioned in the post.

dataposts[]boostOfmentions[]id
string

Account id on `host`.

dataposts[]boostOfmentions[]handle
string

`user@host` of the mentioned account.

dataposts[]boostOfmentions[]username
string

Username without the host.

dataposts[]boostOfmentions[]url
stringnullable

Profile page of the mentioned account.

Custom emojis used in the post.

dataposts[]boostOfemojis[]shortcode
string

Shortcode without colons.

dataposts[]boostOfemojis[]url
stringnullable

Emoji image.

dataposts[]boostOfemojis[]staticUrl
stringnullable

Still frame.

Link preview card, when the post has one.

dataposts[]boostOfcardurl
string

The link the card points to.

dataposts[]boostOfcardtitle
string

Title of the linked page.

dataposts[]boostOfcarddescription
stringnullable

Short description of the linked page.

dataposts[]boostOfcardtype
stringnullable

`link`, `photo`, `video` or `rich`.

dataposts[]boostOfcardproviderName
stringnullable

Site that published the linked page.

dataposts[]boostOfcardproviderUrl
stringnullable

The publisher's own page.

Authors of the linked page.

dataposts[]boostOfcardauthors[]name
stringnullable

Author name.

dataposts[]boostOfcardauthors[]url
stringnullable

Author page.

dataposts[]boostOfcardpublishedAt
stringnullable

When the linked page was published, when known.

dataposts[]boostOfcardlanguage
stringnullable

ISO language code of the linked page, when known.

Preview image, when the link has one.

dataposts[]boostOfcardimageurl
string

Preview image.

dataposts[]boostOfcardimagedescription
stringnullable

Alt text.

dataposts[]boostOfcardimageblurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]boostOfcardimagewidth
integernullable

Width in pixels, when known.

dataposts[]boostOfcardimageheight
integernullable

Height in pixels, when known.

Poll, when the post has one.

dataposts[]boostOfpollid
string

Poll id on `host`.

dataposts[]boostOfpollexpiresAt
stringnullable

When voting closes, when the poll has an end.

dataposts[]boostOfpollexpired
boolean

True when voting has closed.

dataposts[]boostOfpollmultiple
boolean

True when a voter may choose more than one option.

dataposts[]boostOfpollvotes
integernullable

Total votes, or null when the server does not report it.

dataposts[]boostOfpollvoters
integernullable

Distinct voters, or null when the server does not count them.

Poll choices, in the author's order.

dataposts[]boostOfpolloptions[]title
string

Option text.

dataposts[]boostOfpolloptions[]votes
integernullable

Votes for this option, when reported.

Custom emojis used in the poll.

dataposts[]boostOfpollemojis[]shortcode
string

Shortcode without colons.

dataposts[]boostOfpollemojis[]url
stringnullable

Emoji image.

dataposts[]boostOfpollemojis[]staticUrl
stringnullable

Still frame.

The client the author posted from.

dataposts[]boostOfappname
string

Name of the client.

dataposts[]boostOfappwebsite
stringnullable

The client's website.

The quoted post, on servers that support quotes.

dataposts[]quotestate
stringnullable

`accepted`, `pending`, `deleted`...

The quoted post, when it is public.

dataposts[]quotepostid
string

Post id on `host`.

dataposts[]quoteposthost
string

The server this record came from.

dataposts[]quoteposturl
stringnullable

Post page.

dataposts[]quoteposturi
stringnullable

ActivityPub id. Stable across servers.

dataposts[]quotepostcreatedAt
stringnullable

ISO-8601 UTC.

dataposts[]quoteposteditedAt
stringnullable

When the post was last edited, or null.

dataposts[]quotepostlanguage
stringnullable

ISO code, or null when unset.

dataposts[]quotepostcontentHtml
stringnullable

Post body as sanitised HTML.

dataposts[]quoteposttext
stringnullable

Post body as plain text.

dataposts[]quotepostcontentWarning
stringnullable

Content warning text.

dataposts[]quotepostisSensitive
boolean

True when the author marked the post sensitive.

dataposts[]quotepostvisibility
stringnullable

`public` or `unlisted`.

The account that wrote the post.

dataposts[]quotepostauthorid
string

Account id on `host`.

dataposts[]quotepostauthorhost
string

The server this record came from.

dataposts[]quotepostauthorhandle
string

`user@host`, with the account's home server.

dataposts[]quotepostauthorusername
string

Username without the host.

dataposts[]quotepostauthorurl
stringnullable

Profile page.

dataposts[]quotepostauthoractorUri
stringnullable

ActivityPub id, when the server shows it.

dataposts[]quotepostauthordisplayName
stringnullable

Display name.

dataposts[]quotepostauthorbioHtml
stringnullable

Bio as sanitised HTML.

dataposts[]quotepostauthorbio
stringnullable

Bio as plain text.

An avatar or header image.

dataposts[]quotepostauthoravatarurl
stringnullable

Image URL on the server or its media store.

dataposts[]quotepostauthoravatarstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]quotepostauthoravatardescription
stringnullable

Alt text.

An avatar or header image.

dataposts[]quotepostauthorheaderurl
stringnullable

Image URL on the server or its media store.

dataposts[]quotepostauthorheaderstaticUrl
stringnullable

Still frame of an animated image.

dataposts[]quotepostauthorheaderdescription
stringnullable

Alt text.

dataposts[]quotepostauthorcreatedAt
stringnullable

Account creation, rounded to midnight UTC by the server.

dataposts[]quotepostauthorlastPostDate
stringnullable

Date of the latest post (a date, not a time).

The server's own counters.

dataposts[]quotepostauthorstatsfollowers
integernullable

Accounts following this account.

dataposts[]quotepostauthorstatsfollowing
integernullable

Accounts this account follows.

dataposts[]quotepostauthorstatsposts
integernullable

Posts by this account.

dataposts[]quotepostauthorisBot
boolean

True when the account is marked as a bot.

dataposts[]quotepostauthorisGroup
boolean

True when the account is a group.

dataposts[]quotepostauthorisLocked
boolean

Follow requests need approval. Public posts are still public.

dataposts[]quotepostauthorisLimited
boolean

The server's moderators limited (silenced) the account.

dataposts[]quotepostauthorisSuspended
boolean

True when the server suspended the account.

dataposts[]quotepostauthorisDiscoverable
booleannullable

The owner's opt-in to the profile directory and recommendations. null on servers that do not report it.

dataposts[]quotepostauthorisIndexable
booleannullable

The owner's opt-in to search engines indexing public posts. null when not reported.

dataposts[]quotepostauthornoIndex
booleannullable

The owner asks search engines to skip the profile. null when not reported.

dataposts[]quotepostauthorhidesNetwork
booleannullable

The owner hides the follower and following lists. null when not reported.

The account this one moved to.

dataposts[]quotepostauthormovedToid
stringnullable

Account id on the server that returned it.

dataposts[]quotepostauthormovedTohandle
string

`user@host` of the account this one moved to.

dataposts[]quotepostauthormovedTourl
stringnullable

Profile page of the new account.

dataposts[]quotepostauthormovedTodisplayName
stringnullable

Display name of the new account.

Profile metadata fields, in the owner's order.

dataposts[]quotepostauthorfields[]name
string

Label.

dataposts[]quotepostauthorfields[]valueHtml
string

Value as sanitised HTML.

dataposts[]quotepostauthorfields[]value
string

Value as plain text.

dataposts[]quotepostauthorfields[]verifiedAt
stringnullable

When a link in the value was verified with rel=me.

Custom emojis used in the display name or bio.

dataposts[]quotepostauthoremojis[]shortcode
string

Shortcode without colons.

dataposts[]quotepostauthoremojis[]url
stringnullable

Emoji image.

dataposts[]quotepostauthoremojis[]staticUrl
stringnullable

Still frame.

Public badges such as Owner or Moderator.

dataposts[]quotepostauthorroles[]id
stringnullable

Role id on `host`.

dataposts[]quotepostauthorroles[]name
string

Role name, such as Owner or Moderator.

dataposts[]quotepostauthorroles[]color
stringnullable

Badge colour as a hex value, when set.

The post this replies to. Ids belong to `host`.

dataposts[]quotepostreplyTopostId
stringnullable

Id of the post this one replies to, on `host`.

dataposts[]quotepostreplyToaccountId
stringnullable

Id of the account this post replies to, on `host`.

Engagement counters as the server reports them.

dataposts[]quotepoststatsreplies
integernullable

Replies the server counts.

dataposts[]quotepoststatsboosts
integernullable

Boosts the server counts.

dataposts[]quotepoststatsfavourites
integernullable

Favourites the server counts.

dataposts[]quotepoststatsquotes
integernullable

Quotes the server counts, when it reports them.

Media attached to the post.

dataposts[]quotepostmedia[]id
string

Media id on `host`.

dataposts[]quotepostmedia[]type
string

`image`, `video`, `gifv` or `audio`.

one of: image, video, gifv, audio, unknown

dataposts[]quotepostmedia[]url
stringnullable

File on the author's server. Never copied.

dataposts[]quotepostmedia[]previewUrl
stringnullable

Preview image.

dataposts[]quotepostmedia[]originUrl
stringnullable

Where the file lives on the author's own server.

dataposts[]quotepostmedia[]description
stringnullable

Alt text.

dataposts[]quotepostmedia[]blurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]quotepostmedia[]width
integernullable

Width in pixels, when known.

dataposts[]quotepostmedia[]height
integernullable

Height in pixels, when known.

dataposts[]quotepostmedia[]durationSeconds
numbernullable

Duration in seconds for video or audio, when known.

Focal point, -1 to 1.

dataposts[]quotepostmedia[]focusx
number

Horizontal focal point, -1 to 1.

dataposts[]quotepostmedia[]focusy
number

Vertical focal point, -1 to 1.

Hashtags in the post.

dataposts[]quoteposthashtags[]name
string

Hashtag name without the `#`.

dataposts[]quoteposthashtags[]url
stringnullable

Hashtag page on the server.

Accounts mentioned in the post.

dataposts[]quotepostmentions[]id
string

Account id on `host`.

dataposts[]quotepostmentions[]handle
string

`user@host` of the mentioned account.

dataposts[]quotepostmentions[]username
string

Username without the host.

dataposts[]quotepostmentions[]url
stringnullable

Profile page of the mentioned account.

Custom emojis used in the post.

dataposts[]quotepostemojis[]shortcode
string

Shortcode without colons.

dataposts[]quotepostemojis[]url
stringnullable

Emoji image.

dataposts[]quotepostemojis[]staticUrl
stringnullable

Still frame.

Link preview card, when the post has one.

dataposts[]quotepostcardurl
string

The link the card points to.

dataposts[]quotepostcardtitle
string

Title of the linked page.

dataposts[]quotepostcarddescription
stringnullable

Short description of the linked page.

dataposts[]quotepostcardtype
stringnullable

`link`, `photo`, `video` or `rich`.

dataposts[]quotepostcardproviderName
stringnullable

Site that published the linked page.

dataposts[]quotepostcardproviderUrl
stringnullable

The publisher's own page.

Authors of the linked page.

dataposts[]quotepostcardauthors[]name
stringnullable

Author name.

dataposts[]quotepostcardauthors[]url
stringnullable

Author page.

dataposts[]quotepostcardpublishedAt
stringnullable

When the linked page was published, when known.

dataposts[]quotepostcardlanguage
stringnullable

ISO language code of the linked page, when known.

Preview image, when the link has one.

dataposts[]quotepostcardimageurl
string

Preview image.

dataposts[]quotepostcardimagedescription
stringnullable

Alt text.

dataposts[]quotepostcardimageblurhash
stringnullable

Blurhash placeholder for the preview.

dataposts[]quotepostcardimagewidth
integernullable

Width in pixels, when known.

dataposts[]quotepostcardimageheight
integernullable

Height in pixels, when known.

Poll, when the post has one.

dataposts[]quotepostpollid
string

Poll id on `host`.

dataposts[]quotepostpollexpiresAt
stringnullable

When voting closes, when the poll has an end.

dataposts[]quotepostpollexpired
boolean

True when voting has closed.

dataposts[]quotepostpollmultiple
boolean

True when a voter may choose more than one option.

dataposts[]quotepostpollvotes
integernullable

Total votes, or null when the server does not report it.

dataposts[]quotepostpollvoters
integernullable

Distinct voters, or null when the server does not count them.

Poll choices, in the author's order.

dataposts[]quotepostpolloptions[]title
string

Option text.

dataposts[]quotepostpolloptions[]votes
integernullable

Votes for this option, when reported.

Custom emojis used in the poll.

dataposts[]quotepostpollemojis[]shortcode
string

Shortcode without colons.

dataposts[]quotepostpollemojis[]url
stringnullable

Emoji image.

dataposts[]quotepostpollemojis[]staticUrl
stringnullable

Still frame.

The client the author posted from.

dataposts[]quotepostappname
string

Name of the client.

dataposts[]quotepostappwebsite
stringnullable

The client's website.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/mastodon/timelines/public?host=fosstodon.org" \
  -H "x-api-key: YOUR_API_KEY"

Responses

The server's public timeline, or that it is closed.