trend-mastodon git:20260905.4909a33A

Immutable. This exact content is served forever at /api/v1/blob/616987ccae756d7b.

---
name: trend-mastodon
title: "Mastodon Trend Harvester Playbook"
description: "Harvest Mastodon posts and topic conversations into a sourced, server-scoped brief. Activate for Mastodon or Fediverse trend scans and harvesting requests. Verify accessible surfaces, preserve sampling limits, and distinguish observed participation from inferred spread or writing recommendations."
license: Apache-2.0
compatibility: "Octoweb browser access and network access. A signed-in session may be needed for restricted server surfaces."
capabilities: octoweb memory-read memory-write
domains: browser
rules:
  - session(trend) content(mastodon)
  - session(trend) content(fediverse)
  - match(\b(mastodon|fediverse|fedi)\s+(trend|trends|harvest|brief|post|toot)\b)
  - match(\b(harvest|scan|analyze)\s+(mastodon|fediverse)\b)
---

## Overview

Return a reproducible brief of what relevant people are discussing, the evidence they share, and questions a downstream writer could address. Preserve the actual author's words and source URLs; publishing is a downstream step. Scope findings to the observed servers and retrieval period.

## Mental model

Home includes followed accounts and followed hashtags; public timelines support local filtering and may restrict access (official, Timelines, 2026-05). Explore/Trends uses a periodically recalculated internal score: status interactions, tag usage, and link sharing. Don't describe it as algorithm-free or boost-only (official, Trends, 2026-05).

Full-text search depends on server setup. Direct lookup and library search also exist; don't infer that untagged posts are invisible or assert an indexing default (official, Network, 2025-11). A favourite notifies the author without resharing; a boost reshares (official, Network, 2025-11). Neither a ratio nor appearance on different servers proves the path a post travelled.

Quiet public is excluded from public feeds, Explore, and search while remaining profile-visible and eligible for Home; reply delivery normally requires following both participants (official, Posting, 2026-07). A harvest of discoverable public material isn't representative of every conversation.

## Harvest procedure

### Establish scope

Identify the home server, topic, audience, language, intended buying situation, and observation period from the brief. Record software and accessible surfaces before applying Mastodon paths to a Fediverse host. Select other servers from actual relevant participants and topic activity, not an undated category roster (directional).

Read the posting server's current rules when the brief requests downstream opportunities. Independent servers have their own policies; the operated-server terms apply only to mastodon.social and mastodon.online (official, Server terms, 2026-07). Record commercial and AI-content restrictions by URL and scope; don't infer them from a server's niche.

### Resolve surfaces and harvest

Resolve API paths below against the verified server origin. For browser work, follow the links actually exposed by that server and record the resulting URL. Don't hard-code legacy web routes or treat the root landing page as a trends page (directional).

| Surface | Verified entry or discovery procedure | Record |
|---|---|---|
| Trending posts | `/api/v1/trends/statuses` (official, Trends, 2026-05). | Ranked candidates and retrieval time. |
| Trending tags / links | `/api/v1/trends/tags` and `/api/v1/trends/links` (official, Trends, 2026-05). | Relevant topics and primary-source links; retain surface type. |
| Local public timeline | `/api/v1/timelines/public?local=true` (official, Timelines, 2026-05). | Accessible local material; access restrictions if present. |
| Public timeline | `/api/v1/timelines/public` (official, Timelines, 2026-05). | The queried server's results, without calling them a global census. |
| Topic timeline | Append the URL-encoded tag to `/api/v1/timelines/tag/` (official, Timelines, 2026-05). | Recent relevant posts and observed URL. |
| Profiles and conversations | Follow actual author and conversation links returned by the interface (directional). | Original post, reply context, profile, and relevant proof. |
| Collections | Inspect exposed Featured links; Collections have shareable URLs and manual discovery (official, Release, 2026-06). | Curator and relevant opt-in participants; no inferred endorsement. |

A configurable institutional landing page can emphasize server description and recent local-profile updates rather than Trending (official, Release, 2026-06). Keep it as a separate culture surface.

Public and hashtag timeline pagination has a documented default of 20 and maximum of 40 results (official, Timelines, 2026-05). Follow the current documented pagination controls, record the requested and returned counts, and continue until the chosen time cutoff or research budget. Don't assume a snapshot completes a feed. For other surfaces, inspect their own pagination rather than transferring those limits (directional).

When access fails, record the response and authentication state; use an authorized session or another accessible surface. Don't bypass restrictions. An empty page can reflect visibility or access, so report “no relevant posts observed in this sample,” not “dead tag” (directional).

### Preserve evidence

For each selected post, capture the following fields. Use “not observed” for missing values; don't replace them with inferred counts (directional).

| Field group | Contents |
|---|---|
| Identity | Canonical post URL, full federated handle, source server, profile URL. |
| Sampling | Retrieval timestamp and timezone, publication time, queried server, exact surface URL, pagination boundary. |
| Content | Faithful excerpt, topic, format, language, tags, CW, visibility when observable, source/artifact link. |
| Interactions | Displayed boosts, favourites, replies, and quotes; specify observation time and interface. |
| Conversation | Relevant external replies, author self-replies, questions, objections, participants' servers, and actual contribution. |
| Accessibility | Presence and usefulness of media descriptions; distinguish missing metadata from inaccessible inspection. |
| Spread | Each observed server appearance; evidence for any specific boost event. Keep causal path unknown unless documented. |

Deduplicate the same post across surfaces by its canonical URL. Report appearances separately from unique posts. Keep raw excerpts distinct from paraphrases; label interpretation as inference (directional).

Attach sample scope to quantitative summaries using the form “measured, named capture, n=observed sample size, capture month.” Preserve the underlying URLs and calculations. Never label a sample “measured” without a reproducible capture.

### Assess relevance without fake virality thresholds

Compare similar topics and formats at comparable post ages. Prefer evidence relevant to the intended audience over raw popularity. Use qualitative assessments of niche fit and qualified interest; explain each with a cited excerpt or reply (directional).

| Observation | Permitted interpretation |
|---|---|
| Same canonical post on different servers | Cross-server appearance observed; route and causal contributor remain unknown. |
| Relevant people discuss implementation or buying constraints | Candidate qualified-interest evidence; don't infer a purchase. |
| Author adds installments | Explanatory depth; keep separate from independent participation. |
| Numerous reactions with sparse discussion | Visible reaction pattern; no conversion or accessibility-penalty inference. |
| Unavailable view count | Leave it unobserved; don't invent impressions or a reach denominator. |
| A tagged topic repeats | Inspect whether the evidence or audience question is new before calling it saturated. |

A crisis-discourse study associated external replies with wider and more diverse cascades; mention and URL predictors also produced overestimation errors (measured, Discussion study, n=54,333 seed posts, 2026-05). It supports inspecting conversations, not reverse-engineering a sales formula.

Buffer's Mastodon image/video medians exceeded link/text medians modestly; its Mastodon subsample is undisclosed and it offers no Mastodon timing window (measured, Buffer, n=Mastodon subsample undisclosed, 2026-03). Don't prescribe fixed boost ratios, follower cutoffs, ET posting windows, or a federation maturation period.

### Return opportunities only when requested

Separate harvested evidence from optional writing hypotheses. For each hypothesis, identify the unmet question, usable proof, relevant live tags if any, and a limitation. Choose tags by topical need, not account-size quotas. Use the audience's observed timezone and account history for timing experiments; label recommendations directional (directional).

Record actual CW practice alongside local policy; don't declare politics, promotion, or ordinary technical content universally CW-required or exempt. Media descriptions are optional but recommended in Mastodon; absence doesn't establish automatic blocking (official, Posting, 2026-07).

When quotes matter, record the source post's permissions. Anyone is the documented default, with followers or Just me restrictions and revocation controls (official, Quote posts, 2025-11). Don't infer that most authors disable quotes.

Identify relevant ecosystem curators through their public contributions. Collections require discoverability opt-in, notify additions, allow self-removal, and have a cap of 25 with no follow-all (official, Release, 2026-06). A curator list is research output, not authorization to contact people or coordinate boosts.

## Examples

### Cross-server appearance without a causal story

Illustrative reporting pattern, not an observed campaign:

> The canonical post appears on the queried home-server Trends surface and a relevant topic surface elsewhere. The accessible thread contains a question about deployment constraints. No boost event connecting those appearances was captured. Treat the question as an objection to investigate; the route remains unknown.

In an actual brief, attach the canonical URL, surface URLs, timestamps, and the quoted question. Don't promote co-occurrence into a federation-breakout claim.

### Inaccessible hashtag surface

Illustrative reporting pattern:

> The tag surface requires authentication in the available session. Current activity and follower coverage weren't observed. The accessible profile post links to a useful artifact, but it cannot establish that the tag is active.

Return the access limitation and available source. Don't recommend the tag as verified or replace the missing sample with a guessed tag size.

## Checklist

- [ ] Server, software, scope, observation period, language, and access state recorded.
- [ ] Surface URLs verified; pagination and sample boundaries explicit.
- [ ] Each cited post has a canonical URL and full federated handle; repeated appearances deduplicated.
- [ ] Displayed counts timestamped; unavailable data remains unobserved.
- [ ] Independent participation separated from self-replies; boost routes asserted only with evidence.
- [ ] Media descriptions, CW, and relevant policy recorded without invented penalties.
- [ ] Tag activity verified within stated scope; empty or restricted samples aren't labeled globally dead.
- [ ] Optional recommendations distinguish evidence from directional hypotheses; no fixed virality or timing thresholds.
- [ ] Sources and calculations support every measured summary; no invented proof or customer outcomes.
- [ ] Only research-created browser tabs closed; preserve the user's existing tabs.

## References

- [Timelines](https://docs.joinmastodon.org/methods/timelines/) and [Trends](https://docs.joinmastodon.org/methods/trends/), 2026-05.
- [Network](https://docs.joinmastodon.org/user/network/) and [Quote posts](https://docs.joinmastodon.org/user/quote-posts/), 2025-11.
- [Posting](https://docs.joinmastodon.org/user/posting/), 2026-07.
- [Release](https://blog.joinmastodon.org/2026/06/mastodon-4.6/), 2026-06.
- [Server terms](https://blog.joinmastodon.org/2026/07/announcing-new-terms-of-service-for-our-servers/), 2026-07.
- [Buffer](https://buffer.com/resources/state-of-social-media-engagement-2026/), 2026-03, Mastodon subsample undisclosed.
- [Discussion study](https://ojs.aaai.org/index.php/ICWSM/article/download/42774/50334/46875), 2026-05, crisis-discourse population.

Re-validate when web routes, access policies, pagination, or UI labels change; when discovery features ship; when ranking code or benchmark reports change.
Validated: 2026-09