# Social Fetch API - Mastodon endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

24 documented Mastodon operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/mastodon/profiles/{handle}
Get Mastodon profile
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/get.mdx
SDK: client.mastodon.getProfile({ handle: "Gargron@mastodon.social" })
Parameters:
- handle (required, string) - Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
- include (optional, string, enum: featuredTags) - `featuredTags` also returns the hashtags the account features.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/profiles/{handle}/posts
List Mastodon profile posts
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/posts/get.mdx
SDK: client.mastodon.listProfilePosts({ handle: "Gargron@mastodon.social", filter: "media" })
Parameters:
- handle (required, string) - Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
- filter (optional, string, enum: all | original | media | pinned) - `all` (default) includes replies and boosts, `original` leaves them out, `media` keeps posts with media, `pinned` returns the pinned posts.
- tag (optional, string) - Hashtag name without the `#`, e.g. `photography`. Letters of any script are allowed; the server folds case and accents.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 40. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social/posts?filter=media" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/profiles/{handle}/followers
List Mastodon profile followers
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/followers/get.mdx
SDK: client.mastodon.listProfileFollowers({ handle: "Gargron@mastodon.social" })
Parameters:
- handle (required, string) - Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 80. Default: 40.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social/followers" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/profiles/{handle}/following
List who a Mastodon profile follows
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/following/get.mdx
SDK: client.mastodon.listProfileFollowing({ handle: "Gargron@mastodon.social" })
Parameters:
- handle (required, string) - Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 80. Default: 40.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social/following" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/profiles/{handle}/collections
List Mastodon profile collections
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/collections/get.mdx
SDK: client.mastodon.listProfileCollections({ handle: "Gargron@mastodon.social" })
Parameters:
- handle (required, string) - Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/Gargron%40mastodon.social/collections" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/profiles/batch
Get Mastodon profiles by id
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/batch/get.mdx
SDK: client.mastodon.getProfilesBatch({ host: "mastodon.social", ids: ["1"] })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- ids (required, array) - Comma-separated account ids on `host`, 1 to 40. Ids belong to that server.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/profiles/batch?host=mastodon.social&ids=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/posts
Get Mastodon post
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/posts/get.mdx
SDK: client.mastodon.getPost({ url: "https://mastodon.social/@Gargron/117555039933723776" })
Parameters:
- url (required, string) - 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.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/posts?url=https://mastodon.social/@Gargron/117555039933723776" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/posts/context
Get Mastodon post reply tree
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/posts/context/get.mdx
SDK: client.mastodon.getPostContext({ url: "https://mastodon.social/@Gargron/117555039933723776" })
Parameters:
- url (required, string) - 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.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/posts/context?url=https://mastodon.social/@Gargron/117555039933723776" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/posts/edits
List Mastodon post edit history
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/posts/edits/get.mdx
SDK: client.mastodon.listPostEdits({ url: "https://mastodon.social/@Gargron/117555039933723776" })
Parameters:
- url (required, string) - 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.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/posts/edits?url=https://mastodon.social/@Gargron/117555039933723776" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/posts/reactions
List Mastodon post boosts and likes
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/posts/reactions/get.mdx
SDK: client.mastodon.listPostReactions({ url: "https://mastodon.social/@Gargron/117555039933723776", kind: "boosts" })
Parameters:
- url (required, string) - 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.
- kind (required, string, enum: boosts | favourites) - `boosts` lists who boosted the post, `favourites` who favourited it.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 80. Default: 40.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/posts/reactions?url=https://mastodon.social/@Gargron/117555039933723776&kind=boosts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/posts/batch
Get Mastodon posts by id
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/posts/batch/get.mdx
SDK: client.mastodon.getPostsBatch({ host: "mastodon.social", ids: ["1"] })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- ids (required, array) - Comma-separated post ids on `host`, 1 to 20. Ids belong to that server.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/posts/batch?host=mastodon.social&ids=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/timelines/hashtags/{tag}
List posts with a Mastodon hashtag
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/timelines/hashtags/tag/get.mdx
SDK: client.mastodon.listHashtagTimeline({ host: "mastodon.social", tag: "photography" })
Parameters:
- tag (required, string) - Hashtag name without the `#`, e.g. `photography`. Letters of any script are allowed; the server folds case and accents.
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- scope (optional, string, enum: all | local | remote) - `all` (default) is everything the server has seen, `local` only the server's own accounts, `remote` only accounts from other servers.
- mediaOnly (optional, boolean) - Only posts with media attachments.
- any (optional, array) - Also match any of these hashtags (comma-separated).
- all (optional, array) - Also require all of these hashtags (comma-separated).
- none (optional, array) - Exclude posts with these hashtags (comma-separated).
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 40. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/timelines/hashtags/photography?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/timelines/public
List Mastodon server public timeline
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/timelines/public/get.mdx
SDK: client.mastodon.listPublicTimeline({ host: "fosstodon.org" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- scope (optional, string, enum: all | local | remote) - `all` (default) is everything the server has seen, `local` only the server's own accounts, `remote` only accounts from other servers.
- mediaOnly (optional, boolean) - Only posts with media attachments.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 40. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/timelines/public?host=fosstodon.org" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/hashtags/{tag}
Get Mastodon hashtag
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/hashtags/tag/get.mdx
SDK: client.mastodon.getHashtag({ host: "mastodon.social", tag: "photography" })
Parameters:
- tag (required, string) - Hashtag name without the `#`, e.g. `photography`. Letters of any script are allowed; the server folds case and accents.
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/hashtags/photography?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/trends/posts
List Mastodon trending posts
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/trends/posts/get.mdx
SDK: client.mastodon.listTrendingPosts({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`.
- offset (optional, integer) - Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0.
- limit (optional, integer) - Items per page, 1 to 40. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/trends/posts?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/trends/hashtags
List Mastodon trending hashtags
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/trends/hashtags/get.mdx
SDK: client.mastodon.listTrendingHashtags({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`.
- offset (optional, integer) - Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0.
- limit (optional, integer) - Items per page, 1 to 20. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/trends/hashtags?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/trends/links
List Mastodon trending links
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/trends/links/get.mdx
SDK: client.mastodon.listTrendingLinks({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`.
- offset (optional, integer) - Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0.
- limit (optional, integer) - Items per page, 1 to 20. Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/trends/links?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/directory
List Mastodon server profile directory
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/directory/get.mdx
SDK: client.mastodon.listDirectory({ host: "mastodon.social", order: "active" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- order (optional, string, enum: active | new) - `active` (default) most recently active first, `new` newest first.
- scope (optional, string, enum: all | local) - `all` (default) or `local` for the server's own accounts only.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`.
- offset (optional, integer) - Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0.
- limit (optional, integer) - Items per page, 1 to 80. Default: 40.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/directory?host=mastodon.social" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/search
Search Mastodon server
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/search/get.mdx
SDK: client.mastodon.search({ host: "mastodon.social", query: "photography" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- query (required, string) - Search text.
- type (optional, string, enum: accounts | hashtags | posts) - 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.
- limit (optional, integer) - Items per page, 1 to 40. Default: 20.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/search?host=mastodon.social&query=photography" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/servers/{host}
Get Mastodon server
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/servers/host/get.mdx
SDK: client.mastodon.getServer({ host: "mastodon.social", include: ["rules"] })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- include (optional, array) - Comma-separated extras: `rules` (the server's rules) and `about` (its long description).
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social?include=rules" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/servers/{host}/activity
Get Mastodon server weekly activity
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/servers/host/activity/get.mdx
SDK: client.mastodon.listServerActivity({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/activity" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/servers/{host}/peers
List Mastodon server peers
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/servers/host/peers/get.mdx
SDK: client.mastodon.listServerPeers({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- q (optional, string) - Only domains containing this text.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 1000. Default: 100.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/peers" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/servers/{host}/emojis
List Mastodon server custom emoji
Credit cost: 2 credits. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/servers/host/emojis/get.mdx
SDK: client.mastodon.listServerEmojis({ host: "mastodon.social", limit: 200 })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page.
- limit (optional, integer) - Items per page, 1 to 1000. Default: 200.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/emojis?limit=200" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/mastodon/servers/{host}/blocks
List Mastodon server domain blocks
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/mastodon/servers/host/blocks/get.mdx
SDK: client.mastodon.listServerBlocks({ host: "mastodon.social" })
Parameters:
- host (required, string) - The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`, `unsupported`, `not_compatible`
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/blocks" \
  -H "x-api-key: YOUR_API_KEY"