Skip to main content
Mastodon is part of the Fediverse. It’s decentralized, which means “analytics” is a loose concept. Each instance runs independently, and there’s no central authority tracking impressions or views.

​
Supported Content Types

  • Toots (Posts): Text with optional media. Up to 4 files.
  • Mixed images and videos allowed, but only 1 video max.

​
Quirks & Gotchas

​
Terminology

  • Likes = Favourites (British spelling, because Mastodon).
  • Shares = Reblogs (like retweets, but federated).
  • Posts = Toots (or “statuses” in the API, because naming things is hard).

​
Character Limits

Character limits are instance-dependent - most instances default to 500, but some allow more. We can’t know in advance what your user’s instance allows.

​
Media Limits

ConstraintValue
Files0-4 (images and/or videos, mixed allowed)
Max videos1
Video max size99 MB
Video aspect ratio1:3 to 1:1
Max images4
Image max size16 MB each
See Platform Limits for more details.

​
Text & Field Limits

FieldLimit
textMax 30,000 characters
spoilerMax 50 characters

​
Post Options

Send Mastodon-specific options inside data.MASTODON.
FieldTypeDescription
textstringStatus text. Instance limits vary; bundle.social accepts up to 30,000 characters.
uploadIdsstring[]Up to 4 uploaded media files. Only 1 video is allowed.
thumbnailstringOptional thumbnail image URL uploaded through bundle.social.
privacyenumPUBLIC, UNLISTED, PRIVATE, or DIRECT.
spoilerstringContent warning text. Max 50 characters.
{
  "teamId": "team_123",
  "title": "Mastodon update",
  "status": "SCHEDULED",
  "postDate": "2026-06-01T15:00:00.000Z",
  "socialAccountTypes": ["MASTODON"],
  "data": {
    "MASTODON": {
      "text": "Shipping a small but useful update today.",
      "privacy": "PUBLIC",
      "spoiler": "Product update"
    }
  }
}

​
Analytics

For general analytics concepts (refresh rates, data retention, what “Returns 0” means), see the Analytics Overview. Mastodon has very limited analytics capabilities. Being decentralized means there’s no central tracking of impressions or views.

​
Profile Analytics

Period: Snapshot.
MetricDescriptionNote
impressions-Returns 0 (not available)
impressionsUnique-Returns 0 (not available)
views-Returns 0 (not available)
viewsUnique-Returns 0 (not available)
likes-Returns 0 (not available at profile level)
comments-Returns 0 (not available at profile level)
postCountTotal toots
followersFollowers
followingFollowing

​
Post Analytics

Period: Lifetime.
MetricDescriptionNote
impressions-Returns 0 (not available)
impressionsUnique-Returns 0 (not available)
views-Returns 0 (not available)
viewsUnique-Returns 0 (not available)
likesFavourites
commentsReplies
sharesReblogs
saves-Returns 0 (not available)

​
Quirks

  • No impression or view metrics. The Fediverse doesn’t track eyeballs the way corporate social media does.
  • Only basic engagement metrics (favourites, replies, reblogs) are available per post.
  • Profile-level engagement is not aggregated by Mastodon’s API.
  • This is by design, not a bug. Privacy-focused platform = limited tracking.

​
Raw Analytics

Mastodon profile raw analytics store the account payload we fetched from the instance. 
{
  "id": "10987654321",
  "username": "example",
  "acct": "[email protected]",
  "display_name": "Example",
  "statuses_count": 240,
  "followers_count": 1800,
  "following_count": 220
}
Mastodon post raw analytics store the status payload. 
{
  "id": "1122334455",
  "url": "https://mastodon.social/@example/1122334455",
  "content": "<p>Shipping a small update today.</p>",
  "replies_count": 12,
  "reblogs_count": 34,
  "favourites_count": 91,
  "created_at": "2026-04-26T10:30:00.000Z"
}