List Mastodon server peers
List the domains a Mastodon server federates with.
Headers
Get your API keyAPI key (`sfk_...`)
The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
Only domains containing this text.
min 1 chars · max 100 chars
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 512 chars
Items per page, 1 to 1000. Default: 100.
≥ 1 · ≤ 1000
Endpoint-specific response payload.
`found`, `not_found`, `restricted` (login required or closed), `unsupported` (this server does not offer it) or `not_compatible` (the host is not a Mastodon-compatible server). See `reason`.
one of: found, not_found, restricted, unsupported, not_compatible
The server that was asked.
Only on a `not_compatible` result (and always on the server endpoint): the software the host runs, from its NodeInfo, e.g. `misskey` or `lemmy`; null when it does not say. Absent otherwise.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: login_required, closed_by_operator, hidden_by_owner, suspended, not_implemented, disabled_by_operator, not_a_mastodon_server, unsupported_server_software, host_not_found, post_not_visible
Plain-language explanation.
The text `q` filtered by, or null when it was omitted.
Domains matching `q` (or all domains) across every page.
Domains the server has seen. Includes dead domains and servers running other software.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/peers" \
-H "x-api-key: YOUR_API_KEY"Responses
Domains the server has seen.