Mastodon

Search Mastodon server

Search a Mastodon server for accounts, hashtags or posts.

GET/v1/mastodon/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
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.

querystringrequiredquery

Search text.

min 1 chars · max 300 chars

typestringoptionalquery

What to search. Omit for accounts and hashtags. `posts` works only on servers whose software allows searching posts without a login (Pleroma, Akkoma and some others); Mastodon itself does not.

one of: accounts, hashtags, posts

limitintegeroptionalquery

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

≥ 1 · ≤ 40

Response fields
473

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.

dataquery
string

The search text that was asked for.

datatype
stringnullable

The type that was asked for, or null when it was omitted.

one of: accounts, hashtags, posts, null

Matching accounts, in the server's order.

dataaccounts[]id
string

Account id on `host`.

dataaccounts[]host
string

The server this record came from.

dataaccounts[]handle
string

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

dataaccounts[]username
string

Username without the host.

dataaccounts[]url
stringnullable

Profile page.

dataaccounts[]actorUri
stringnullable

ActivityPub id, when the server shows it.

dataaccounts[]displayName
stringnullable

Display name.

dataaccounts[]bioHtml
stringnullable

Bio as sanitised HTML.

dataaccounts[]bio
stringnullable

Bio as plain text.

An avatar or header image.

dataaccounts[]avatarurl
stringnullable

Image URL on the server or its media store.

dataaccounts[]avatarstaticUrl
stringnullable

Still frame of an animated image.

dataaccounts[]avatardescription
stringnullable

Alt text.

An avatar or header image.

dataaccounts[]headerurl
stringnullable

Image URL on the server or its media store.

dataaccounts[]headerstaticUrl
stringnullable

Still frame of an animated image.

dataaccounts[]headerdescription
stringnullable

Alt text.

dataaccounts[]createdAt
stringnullable

Account creation, rounded to midnight UTC by the server.

dataaccounts[]lastPostDate
stringnullable

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

The server's own counters.

dataaccounts[]statsfollowers
integernullable

Accounts following this account.

dataaccounts[]statsfollowing
integernullable

Accounts this account follows.

dataaccounts[]statsposts
integernullable

Posts by this account.

dataaccounts[]isBot
boolean

True when the account is marked as a bot.

dataaccounts[]isGroup
boolean

True when the account is a group.

dataaccounts[]isLocked
boolean

Follow requests need approval. Public posts are still public.

dataaccounts[]isLimited
boolean

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

dataaccounts[]isSuspended
boolean

True when the server suspended the account.

dataaccounts[]isDiscoverable
booleannullable

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

dataaccounts[]isIndexable
booleannullable

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

dataaccounts[]noIndex
booleannullable

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

dataaccounts[]hidesNetwork
booleannullable

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

The account this one moved to.

dataaccounts[]movedToid
stringnullable

Account id on the server that returned it.

dataaccounts[]movedTohandle
string

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

dataaccounts[]movedTourl
stringnullable

Profile page of the new account.

dataaccounts[]movedTodisplayName
stringnullable

Display name of the new account.

Profile metadata fields, in the owner's order.

dataaccounts[]fields[]name
string

Label.

dataaccounts[]fields[]valueHtml
string

Value as sanitised HTML.

dataaccounts[]fields[]value
string

Value as plain text.

dataaccounts[]fields[]verifiedAt
stringnullable

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

Custom emojis used in the display name or bio.

dataaccounts[]emojis[]shortcode
string

Shortcode without colons.

dataaccounts[]emojis[]url
stringnullable

Emoji image.

dataaccounts[]emojis[]staticUrl
stringnullable

Still frame.

Public badges such as Owner or Moderator.

dataaccounts[]roles[]id
stringnullable

Role id on `host`.

dataaccounts[]roles[]name
string

Role name, such as Owner or Moderator.

dataaccounts[]roles[]color
stringnullable

Badge colour as a hex value, when set.

Matching hashtags, in the server's order.

datahashtags[]name
string

Hashtag name without the `#`.

datahashtags[]url
stringnullable

Hashtag page on the server.

Daily uses and distinct accounts, newest first.

datahashtags[]history[]date
string

UTC date, `YYYY-MM-DD`.

datahashtags[]history[]uses
integer

Times the hashtag was used that day.

datahashtags[]history[]accounts
integer

Distinct accounts that used the hashtag that day.

Matching posts, in the server's order.

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.

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/search?host=mastodon.social&query=photography" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Accounts, hashtags or posts matching the query.