# Mastodon API

**Provider:** Mastodon
**Category:** social
**Base URL:** `https://mastodon.social/api/v1`
**Auth:** bearer — `Authorization: Bearer YOUR_ACCESS_TOKEN`
**Rate Limit:** 300 requests per 5 minutes per user
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://docs.joinmastodon.org/api/

## Description

Open-source decentralized social network API for account management, posting statuses, reading timelines, and social interactions on the Mastodon platform.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://mastodon.social/api/v1/timelines/home` | Get home timeline |
| GET | `https://mastodon.social/api/v1/timelines/public` | Get public timeline |
| POST | `https://mastodon.social/api/v1/statuses` | Post a new status |
| GET | `https://mastodon.social/api/v1/accounts/verify_credentials` | Verify credentials |
| GET | `https://mastodon.social/api/v1/accounts/{id}` | Get an account |
| GET | `https://mastodon.social/api/v1/accounts/search` | Search for accounts |
| POST | `https://mastodon.social/api/v1/accounts/{id}/follow` | Follow an account |
| GET | `https://mastodon.social/api/v1/notifications` | Get notifications |

## Authentication

Bearer token in the Authorization header (obtained via OAuth 2.0)

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://mastodon.social/api/v1/timelines/public'
```

## Sample Response

```json
[{"id":"123","content":"<p>Hello world</p>","created_at":"2024-01-01T00:00:00.000Z"}]
```

## Pricing Details

Open-source software; any Mastodon instance exposes this API for free.

---

*Source: [API Map](https://apimap.dev/apis/mastodon/) — CC BY 4.0*