Free APISocialOAuthOfficial

Mastodon API

Read public fediverse timelines and posts from any instance, often keyless

Every Mastodon instance exposes the same REST API. Public, local, and hashtag timelines plus individual statuses and public account posts can be read without authentication when the instance admin allows public preview (the default on large instances like mastodon.social). Posting and home timelines require an OAuth app token.

View docs Get an API key

Free tier

Free; public reads keyless, posting needs OAuth

Rate limits

300 requests / 5 min per IP (default; instance-configurable)

Auth

OAuth

Base URL

https://mastodon.social/api/v1

What you'd build with it

Monitor a hashtag across the fediverse for brand or topic mentions
Mirror a public account's posts into a content feed
Auto-post automation announcements to a Mastodon account via OAuth

Key endpoints

GET/timelines/publicFederated or local public timeline (no auth if instance allows)
GET/timelines/tag/{hashtag}Public posts for a hashtag
GET/accounts/{id}/statusesA public account's recent posts
POST/statusesCreate a post (Bearer token required)

Members

Members get the runnable recipe

Create a free account Sign in