# Vextorium Mastodon Trending Tags

> Vextorium Mastodon Trending Tags 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 hashtags currently trending on a specified Mastodon instance, with usage counts for today and the past 7 days, plus the number of accounts using them today.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/mastodon-trending-tags?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-tags-9ed54331
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YGBM0Qgr_W9-IfP2owhQP

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-tags-9ed54331 -d '<json body>'
```

Example prompt: What are the top 20 trending hashtags on mastodon.social right now, including how many times each has been used today and over the past week?

## When to prefer this

Choose this endpoint when you need real-time trending hashtag data from a specific Mastodon/fediverse instance, including both daily and 7-day usage statistics and account counts. Prefer it over generic social media trend APIs when the user specifically wants fediverse or Mastodon data rather than Twitter/X trends.

## Known failure modes

- Invalid or unreachable Mastodon instance returns an error or empty result
- Instance does not expose public trending-tags API (some instances disable it)
- Limit parameter out of range may be clamped or cause an error
- Network timeout if the Mastodon instance is slow to respond

## 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

A JSON array of trending hashtags, each with the tag name, a direct URL to the tag page on the instance, the number of uses in the last 7 days, the number of uses today, and the number of unique accounts that used it today — plus a total count and the source instance name.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tags": [
   {
    "tag": "バーガータワー",
    "url": "https://mastodon.social/tags/%E3%83%90%E3%83%BC%E3%82%AC%E3%83%BC%E3%82%BF%E3%83%AF%E3%83%BC",
    "uses_7d": 317,
    "uses_today": 39,
    "accounts_today": 23
   },
   {
    "tag": "PrankANeighborBooks",
    "url": "https://mastodon.social/tags/prankaneighborbooks",
    "uses_7d": 225,
    "uses_today": 225,
    "accounts_today": 51
   }
  ],
  "count": 20,
  "source": "Mastodon public API (mastodon.social)",
  "instance": "mastodon.social"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-mastodon-trending-tags-9ed54331/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)