# Vextorium Mastodon Trending Posts

> Vextorium Mastodon Trending Posts is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-18).

Returns the most-engaged posts on a Mastodon instance right now, including author, text, favourites, boosts, and replies.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/mastodon-trending-posts?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-mastodon-trending-posts-3ec7ac37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V0CfGMqLQXdeqI-4R1j8i

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-mastodon-trending-posts-3ec7ac37 -d '<json body>'
```

Example prompt: What are the top 20 trending posts on mastodon.social right now — show me the author, text, and how many boosts and favourites each got?

## When to prefer this

Use this endpoint when you need real-time engagement-ranked posts from a specific Mastodon instance, including full text and author details. Prefer it over scraping Mastodon's web UI or using the raw Mastodon API directly when you want a simple, paid-per-call abstraction without authentication overhead. Ideal for trend monitoring, content curation, and social listening on the Fediverse.

## Known failure modes

- Invalid or unreachable Mastodon instance hostname returns an error or empty result
- Instance with no trending data (e.g. small servers with disabled trending) returns empty posts array
- Limit value out of acceptable range may be ignored or cause a validation error
- Rate limiting by the target Mastodon instance may result in stale or incomplete data
- Non-Mastodon ActivityPub servers passed as instance may fail silently

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with a count field and an array of posts, each containing the post URL, full text, author handle, author display name, language code, creation timestamp, favourite count, boost count, and reply count, plus the source instance hostname.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "instance": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "posts": [
   {
    "url": "https://tech.lgbt/@Natasha_Jay/117432189720716241",
    "text": "\"Alien is a movie where nobody listens to the smart woman, and then they all die except for the smart woman and her cat. Four (⭐⭐⭐⭐) stars.\"",
    "author": "Natasha_Jay@tech.lgbt",
    "boosts": 172,
    "replies": 12,
    "language": "en",
    "created_at": "2026-10-13T06:30:12.000Z",
    "favourites": 306,
    "author_name": "Nαtαshα :mastodon:"
   },
   {
    "url": "https://mastodon.social/@gutenberg_org/117432401844117791",
    "text": "\"The Analytical Engine weaves algebraic patterns just as the Jacquard loom weaves flowers and leaves.\" Let's celebrate, today is Ada Lovelace Day! Ada Lovelace, daughter of Lord Byron, was a pioneering mathematician. Known for creating the first machine algorithm for Babbage's Analytical Engine, she…",
    "author": "gutenberg_org",
    "boosts": 87,
    "replies": 1,
    "language": "en",
    "created_at": "2026-10-13T07:24:08.844Z",
    "favourites": 44,
    "author_name": "Project Gutenberg"
   }
  ],
  "source": "Mastodon public API (mastodon.social)",
  "instance": "mastodon.social"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-mastodon-trending-posts-3ec7ac37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)