# Vextorium Mastodon Media Feed

> Vextorium Mastodon Media Feed 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).

Fetches the latest posts from a Mastodon account that contain images, video, or audio, returning media URLs, types, and alt text.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/mastodon-media?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-media-feed-f0dd5b02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7uUDQDvd0GbpC0F-e9hbu

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-media-feed-f0dd5b02 -d '<json body>'
```

Example prompt: Pull the last 10 posts with images, video, or audio from Gargron@mastodon.social and give me the media links and any alt text descriptions.

## When to prefer this

Use this endpoint when you specifically need media-rich posts (images, video, audio) from a known Mastodon account and want structured data including alt text and engagement metrics. Prefer this over general Mastodon API wrappers when you need a simple pay-per-call interface without OAuth setup, or when building agents that monitor fediverse media content.

## Known failure modes

- Account not found or misspelled handle returns empty results or an error
- Private or suspended Mastodon accounts return no posts
- Instance is down or rate-limiting causes request failure
- Account exists but has no media posts, returning an empty posts array
- Invalid limit value (e.g. negative or non-integer) may cause a validation error

## 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 object with a count of returned posts and an array of posts, each containing media attachments (URL, type, alt text/description), post URL, post text, author handle and display name, boost/reply/favourite counts, language, and creation timestamp. Also includes the source instance and queried account handle.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "posts": [
   {
    "avg": [
     {
      "url": "https://files.mastodon.social/media_attachments/files/117/430/624/885/722/830/original/e431ed724a210273.jpg",
      "type": "image",
      "description": "The front of a house and a path leading up to it that's surrounded by hedges on both sides. A calico cat is walking confidently towards the camera in the center of the path. The windows have shutters and awnings."
     }
    ],
    "url": "https://mastodon.social/@Gargron/117430639765794729",
    "text": "A photo from our trip to Tuscany earlier this year that I have not posted so far because I don't consider it very good. 📷️ Pentax KX 🎞️ Fuji Superia X-tra 400 🔭 Pentax M 50mm/1.7 ⚗️ Spieker Film Lab # BelieveInFilm # FilmPhotography # AnalogPhotography # 35mm",
    "author": "Gargron",
    "boosts": 9,
    "replies": 3,
    "language": "en",
    "created_at": "2026-10-12T23:56:01.666Z",
    "favourites": 83,
    "author_name": "Eugen Rochko"
   },
   {
    "avg": [
     {
      "url": "https://files.mastodon.social/media_attachments/files/117/428/005/383/549/828/original/26da628b00c7539b.png",
      "type": "image",
      "description": "A Cronenberg burger. Cronenburger?"
     }
    ],
    "url": "https://mastodon.social/@Gargron/117428010839859006",
    "text": "「ハガバーガンーーーンバババガンー」完成！ 高さ 27.2 cm https:// x282665.com/games/burger-tower/ # バーガータワー",
    "author": "Gargron",
    "boosts": 12,
    "replies": 1,
    "language": "ja",
    "created_at": "2026-10-12T12:47:27.444Z",
    "favourites": 39,
    "author_name": "Eugen Rochko"
   }
  ],
  "source": "Mastodon public API (mastodon.social)",
  "account": "Gargron@mastodon.social"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-mastodon-media-feed-f0dd5b02/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)