# Mastodon data API for AI agents: from $0.001 per call ($1 per 1,000), no subscription

> Whizbrew's Mastodon data API costs from $0.001 per call ($1 per 1,000 calls); a typical call is $0.002 ($2 per 1,000). Only a call that returns data is charged: an empty or failed call is free. There is no subscription and no monthly fee. A new account starts with $2 of free credit, with no card.

It reads public Mastodon data: 11 tools, live at the moment of the call, over one API key or one MCP server (`https://whizbrew.com/mcp`). It is an API, not a scraper you run: no proxies, no browser and no scraping code on your side. The same key reaches 893 tools for other platforms ([all APIs](https://whizbrew.com/api), [all tools](https://whizbrew.com/tools?a=1c47777dae72), [pricing](https://whizbrew.com/pricing?a=1c47777dae72)).

## Pricing

| Tool | What it returns | Per call that returns data | Per 1,000 calls |
|---|---|---|---|
| `mastodon.trends` | Hashtags trending on a Mastodon server, with posts and accounts today and over 7 days. | $0.001 | $1 |
| `mastodon.tag_posts` | Newest public Mastodon posts with a hashtag, with author, text, replies, boosts and likes. Pass next_max_id as max_id to read on. | $0.001 | $1 |
| `mastodon.profile` | Public Mastodon profile: followers, following, post count, bio and profile links. | $0.001 | $1 |
| `mastodon.posts` | Newest public posts of a Mastodon account, boosts included, with replies, boosts and likes. Pass next_max_id as max_id to read on. | $0.002 | $2 |
| `mastodon.post` | One public Mastodon post by URL or id, with the posts it answers (parents, oldest first) and the replies to it. Each reply names the post it answers in reply_to. A URL is read on its own server. | $0.003 | $3 |
| `mastodon.search` | Search a Mastodon server for accounts or hashtags. Hashtags come with posts and accounts today and over 7 days. Posts cannot be searched without a login, so there is no post search. | $0.002 | $2 |
| `mastodon.instance` | A Mastodon server: title, description, version, active users per month, languages, whether registrations are open, rules, contact, thumbnail, and posts, logins and registrations per week (newest week first, still running). | $0.003 | $3 |
| `mastodon.directory` | The profile directory of a Mastodon server: accounts that chose to be listed, most recently active or newest first. Pass next_offset as "offset" to read on. | $0.002 | $2 |
| `mastodon.trending_links` | News links trending on a Mastodon server, with title, description, publisher and how many posts and accounts shared each today and over 7 days. Pass next_offset as "offset" to read on. | $0.002 | $2 |
| `mastodon.trending_posts` | Posts trending on a Mastodon server right now, with author, text, replies, boosts and likes. Pass next_offset as "offset" to read on. | $0.002 | $2 |
| `mastodon.followers` | Accounts that follow a Mastodon account, newest follower first, read on the account's own server. An account that hides its network answers an empty list with a note. Pass next_max_id as max_id to read on. | $0.003 | $3 |

## Example calls

`mastodon.trends` ($0.001 per call): Hashtags trending on a Mastodon server, with posts and accounts today and over 7 days

```
curl -s -X POST https://whizbrew.com/v1/call/mastodon.trends \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"limit":3}'
```

`mastodon.tag_posts` ($0.001 per call): Newest public Mastodon posts with a hashtag, with author, text, replies, boosts and likes

```
curl -s -X POST https://whizbrew.com/v1/call/mastodon.tag_posts \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"limit":3,"tag":"rust"}'
```

`mastodon.profile` ($0.001 per call): Public Mastodon profile: followers, following, post count, bio and profile links

```
curl -s -X POST https://whizbrew.com/v1/call/mastodon.profile \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"handle":"@Gargron@mastodon.social"}'
```

Over MCP the same call is `call_tool` with `{"tool": "<name>", "arguments": {…}}`. How often each tool works, measured from real calls: [https://whizbrew.com/status](https://whizbrew.com/status).

## Start

- **An agent on its own**: read [https://whizbrew.com/agents.md?a=1c47777dae72](https://whizbrew.com/agents.md?src=body-text&a=1c47777dae72). It asks for a free quote (`GET https://whizbrew.com/v1/agent/guide?goal=<the task in plain words>`), then one request (`POST https://whizbrew.com/v1/agent/start?a=1c47777dae72`) gives it a key that works at once with the free credit, with no email and no sign-up form. Its human claims the account later.
- **A chat app** (ChatGPT, Claude, Gemini): add the MCP server `https://whizbrew.com/mcp` as a custom connector and sign in. No key to copy.
- **An agent with a shell** (Claude Code, Codex, Cursor): read [https://whizbrew.com/llms.txt?a=1c47777dae72](https://whizbrew.com/llms.txt?src=body-text&a=1c47777dae72). The agent starts a pairing with one request, its user approves with one click, and the agent holds its own key.
- **Plain HTTP**: create an account at [https://whizbrew.com/app#signup](https://whizbrew.com/app#signup), make a key, then `POST https://whizbrew.com/v1/call/<tool>` with `Authorization: Bearer <key>`.
