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.
Mastodon endpoints
All endpoints authenticate via x-api-key
Look up a fediverse account
/v1/mastodon/profile
Looks up acct (user@instance) on that instance's public API. No application token.
List an account's statuses
/v1/mastodon/account/statuses
Provide one of: acct, id. One page of public statuses. Pass acct, or id together with instance. max_id is the older-than cursor. An empty page costs 0 credits.
Fetch one status
/v1/mastodon/status
One public status by id on instance. HTML is returned as content and as text with tags removed.
Hashtag timeline
/v1/mastodon/hashtag
One page of the public tag timeline on instance. An empty page costs 0 credits.
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.