Documentation Index
Fetch the complete documentation index at: https://info.bundle.social/llms.txt
Use this file to discover all available pages before exploring further.
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.
| Constraint | Value |
|---|
| Files | 0-4 (images and/or videos, mixed allowed) |
| Max videos | 1 |
| Video max size | 99 MB |
| Video aspect ratio | 1:3 to 1:1 |
| Max images | 4 |
| Image max size | 16 MB each |
Text & Field Limits
| Field | Limit |
|---|
text | Max 30,000 characters |
spoiler | Max 50 characters |
Post Options
Send Mastodon-specific options inside data.MASTODON.
| Field | Type | Description |
|---|
text | string | Status text. Instance limits vary; bundle.social accepts up to 30,000 characters. |
uploadIds | string[] | Up to 4 uploaded media files. Only 1 video is allowed. |
thumbnail | string | Optional thumbnail image URL uploaded through bundle.social. |
privacy | enum | PUBLIC, UNLISTED, PRIVATE, or DIRECT. |
spoiler | string | Content 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.
| Metric | Description | Note |
|---|
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) |
postCount | Total toots | |
followers | Followers | |
following | Following | |
Post Analytics
Period: Lifetime.
| Metric | Description | Note |
|---|
impressions | - | Returns 0 (not available) |
impressionsUnique | - | Returns 0 (not available) |
views | - | Returns 0 (not available) |
viewsUnique | - | Returns 0 (not available) |
likes | Favourites | |
comments | Replies | |
shares | Reblogs | |
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
}
{
"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"
}
