Skip to content
4 endpoints From 1 credit / call 0 credits on error & cache hits

Mastodon API

Get public Mastodon data as typed JSON: look up a fediverse account, list an account's statuses, fetch one status and hashtag timeline. One API key, and a published credit cost for every endpoint.

4 endpoints — request parameters, real sample responses, and exact costs.
No platform account or app review. Unofficial API for public data only.
Endpoints

Mastodon endpoints

All endpoints authenticate via x-api-key

Mastodon guides

Mastodon API FAQ

How much does the Mastodon API cost?

Every Mastodon endpoint costs 1 credit per call by default. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.

Do I need a Mastodon account or developer app?

No. You call Fetchproof with one API key in the x-api-key header. It returns public Mastodon data only, so there's no Mastodon login, OAuth or app review.

What happens when a call fails or finds nothing?

Errors cost 0 credits, and so do cache hits on endpoints that take cache_max_age. An empty result costs 0 on List an account's statuses and Hashtag timeline. Each endpoint page lists its own rules.

Which Mastodon data can I get?

4 endpoints: Look up a fediverse account, List an account's statuses, Fetch one status and Hashtag timeline.

Is there a free trial?

Yes. Sign up with an email address to get 100 free credits, with no card. Credits never expire.

Ready to try it? Get 100 free credits or compare credit packs.