Mastodon API pricing vs pay-per-call
fact The official terms below are the exact words on Mastodon's own page, read 21 November 2026: free, with a default limit per account and per IP. On FoxAPIs one Mastodon call reads one post from its address and costs 2 credits.
What Mastodon publishes
| Tier or rule | Price or limit | The words on the official page |
|---|---|---|
| Default limit | free, 300 calls within 5 minutes | fact “All endpoints and methods can be called 300 times within 5 minutes” |
Re-read 21 November 2026: every phrase below was still found on the official page (first read 21 November 2026). The page is read again every week; if a price changes, the change is dated here.
Your calls a month: official cost against FoxAPIs
Official: $0 (free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each)). FoxAPIs: $196 (20,000 credits; at the smallest paid plan rate; the Production plan covers it). At 10,000 calls a month the official API is free (free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each)); FoxAPIs would cost about $196. Choose FoxAPIs for one key across sources, not for price.
estimate Our arithmetic, not the vendor's: the official side applies the published figures above to your number, and the FoxAPIs side is credits per call times the smallest paid plan's price per credit.Formula A call that returns nothing is not charged by FoxAPIs; the official page's own rules decide what it counts.
| Calls a month | Official cost | How the official cost is reached | FoxAPIs costFormula | How the FoxAPIs cost is reached |
|---|---|---|---|---|
| 1,000 | $0 | free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each) | $19.60 | 2,000 credits; at the smallest paid plan rate; the Builder plan covers it |
| 10,000 | $0 | free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each) | $196 | 20,000 credits; at the smallest paid plan rate; the Production plan covers it |
| 100,000 | $0 | free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each) | $1,960 | 200,000 credits; more credits than the largest listed plan holds, so the dollar figure is the per-credit rate and a quote may differ |
| 1,000,000 | $0 | free: inside the default quota of 86,400 calls a day (about 2,592,000 calls a month at 1 call each) | $19,600 | 2,000,000 credits; more credits than the largest listed plan holds, so the dollar figure is the per-credit rate and a quote may differ |
What Mastodon's own terms mean in practice
Mastodon's official API is free. The rate-limit page states: 'All endpoints and methods can be called 300 times within 5 minutes'. That is the default limit, applied per account and per IP. For a builder, this means no invoice and no per-call meter, but a hard ceiling on throughput. You can make 300 calls within 5 minutes, then you wait for the window to roll. There is no published price to raise that ceiling, because there is no price at all. The cap is the product's constraint, not a billing tier.
At the edge, the cap bites on bursts, not on monthly volume. A script that posts once a minute never approaches 300 calls within 5 minutes. A backfill, a sync job, or a fan-out across many accounts can hit the ceiling quickly, and the official answer is to slow down and retry after the window. The official model is free and metered by time, not by credits. Nothing in the official terms charges you for the 1,000th call or the 1,000,000th call; the only cost is waiting when you exceed 300 calls within 5 minutes.
When pay-per-call fits
FoxAPIs fits when your Mastodon posting volume is bursty and you would rather pay per call than pace yourself against 300 calls within 5 minutes. The call compared here is POST /v1/social/mastodon/post, which reads one post from its address at 2 credits a call. The free plan holds 100 credits a month, so 50 calls are covered before you pay anything. At 1,000 calls a month you need 2,000 credits, about $19.60 at the smallest paid plan's rate. At 10,000 calls it is 20,000 credits, about $196. At 100,000 calls it is 200,000 credits, about $1,960. At 1,000,000 calls it is 2,000,000 credits, about $19,600. These are real costs against a free official API, so choose this path for convenience and burst headroom, not for savings.
When to stay on the official API
Stay on the official API whenever your Mastodon posting fits inside 300 calls within 5 minutes and you can absorb the wait at the edge. The official figures are plain: 1,000 calls a month cost $0; 10,000 calls a month cost $0; 100,000 calls a month cost $0; 1,000,000 calls a month cost $0. Against those numbers, FoxAPIs at about $19.60, about $196, about $1,960 and about $19,600 is more expensive at every volume shown. The official API is cheaper, and at these volumes it is free. If your workload is steady rather than bursty, the cap rarely matters, and paying per call buys you nothing the official terms do not already give you.
Questions builders ask about Mastodon API costs
Is the Mastodon API really free? Yes. The official model is free, with a default limit per account and per IP. The official page states: 'All endpoints and methods can be called 300 times within 5 minutes'. There is no per-call price and no credit balance. Your constraint is the 300 calls within 5 minutes window, not a bill.
What does 10,000 calls a month cost on each path? On the official API it is $0. On FoxAPIs, at 2 credits a call, it is 20,000 credits, about $196 at the smallest paid plan's rate. The official API is free at this volume; the pay-per-call path is not.
Does the free FoxAPIs plan cover light posting? The free plan holds 100 credits a month. At 2 credits a call, that covers 50 calls a month. Beyond that you move to the smallest paid plan, where 1,000 calls a month is 2,000 credits, about $19.60. The official API remains $0 at that volume.
What FoxAPIs returns, and what only the official API has
One FoxAPIs call, POST /v1/social/mastodon/post, reads one post from its address and returns these fields in the real captured sample: url, platform, extracted_at, text, title, author_name, author_handle, author_url, author_avatar, author_followers, author_verified, published_at, date_source, likes. The full sample, the price and code in curl, Python and JavaScript are on the Mastodon API page, which also runs one call free with no key.
What FoxAPIs does not do: it reads, it does not write or stream, and it answers the calls on that page, not every method of the official API.
Other platforms: Stack Overflow · Pinterest · openFDA · all of them
How we calculate the Formula figures.