AI agents: read https://whizbrew.com/llms.txt (plain text: what Whizbrew is, what a call costs, how to start). This page as Markdown: https://whizbrew.com/api/mastodon-data-api.md, or send Accept: text/markdown. Prices as data: /manifest.json.

WhizbrewToolsAPIsPricingDocsStatusStart free

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, all tools, pricing).

Pricing

ToolWhat it returnsPer call that returns dataPer 1,000 calls
mastodon.trendsHashtags trending on a Mastodon server, with posts and accounts today and over 7 days.$0.001$1
mastodon.tag_postsNewest 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.profilePublic Mastodon profile: followers, following, post count, bio and profile links.$0.001$1
mastodon.postsNewest 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.postOne 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.searchSearch 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.instanceA 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.directoryThe 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_linksNews 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_postsPosts 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.followersAccounts 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.

Start