APIs / Social media / Mastodon
Mastodon API
Get Mastodon data as structured JSON with one API key: search, hashtag, profile and status. Free credits every month.
curl "https://api.perceptlayer.com/v1/mastodon/search?instance=mastodon.social&q=mastodon&type=accounts&resolve=0&limit=5" \
-H "X-API-Key: $API_KEY"Mastodon · 5 endpoints
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
| Endpoint | What it returns | Cost |
|---|---|---|
GET/v1/mastodon/hashtag | Hashtag Needs terms | 1 credit |
GET/v1/mastodon/profile | Profile Needs terms | 1 credit |
GET/v1/mastodon/search | Search Needs terms | 1 credit |
GET/v1/mastodon/status | Status Needs terms | 1 credit |
GET/v1/mastodon/statuses | Statuses Needs terms | 1 credit |
What you can get
The Mastodon API returns search, hashtag, profile and status as clean JSON. Each successful call costs one credit, and calls that fail are free.
Use cases
- Monitor mentions of your brand
- Find and vet creators
- Track trends and engagement over time
Questions
How much does the Mastodon API cost?
Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Do I need a separate key for Mastodon?
No. One key works for every API in the catalogue.
Related
More social media APIs
Try the Mastodon API with 1,000 free credits
No card and no password. We email you a sign-in link, and your key works on every API.
No credit card. 1,000 free credits a month.