Open-source decentralized social network API for account management, posting statuses, reading timelines, and social interactions on the Mastodon platform.
https://mastodon.social/api/v1
Auth type
Bearer Token
Auth header
Authorization: Bearer YOUR_ACCESS_TOKEN
Rate limit
300 requests per 5 minutes per user
Pricing
Free tier available
Free quota
Free to use on any Mastodon instance
Documentation
https://docs.joinmastodon.org/api/
Endpoint status
Server online — HTTP 404 — server is online but path returned an error (may require auth)2.06s
(checked Mar 29, 2026)
Builder score
C
62%
builder-friendly
Bearer token in the Authorization header (obtained via OAuth 2.0)
Authorization: Bearer YOUR_ACCESS_TOKEN
Open-source software; any Mastodon instance exposes this API for free.
| Method | Path | Description |
|---|---|---|
| GET | /timelines/home |
Get home timeline |
| GET | /timelines/public |
Get public timeline |
| POST | /statuses |
Post a new status |
| GET | /accounts/verify_credentials |
Verify credentials |
| GET | /accounts/{id} |
Get an account |
| GET | /accounts/search |
Search for accounts |
| POST | /accounts/{id}/follow |
Follow an account |
| GET | /notifications |
Get notifications |
curl -X GET 'https://mastodon.social/api/v1/timelines/public'
[{"id":"123","content":"<p>Hello world</p>","created_at":"2024-01-01T00:00:00.000Z"}]
Data sourced from API Map. Always verify pricing and rate limits against the official Mastodon documentation.