Mastodon

Get Mastodon server weekly activity

Get twelve weeks of activity for a Mastodon server.

GET/v1/mastodon/servers/{host}/activity
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
hoststringrequiredpath

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

Response fields
16

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.

Weekly activity, newest first.

dataweeks[]weekStart
string

Start of the week, `YYYY-MM-DD` (UTC). Weeks are counted back from the request time, so the first entry is the week in progress.

dataweeks[]posts
integer

Posts reported for that week.

dataweeks[]activeUsers
integer

Accounts active that week, as the server reports it.

dataweeks[]registrations
integer

New accounts that week, as the server reports it.

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/servers/mastodon.social/activity" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Twelve weeks of posts, active users and sign-ups.