Search Mastodon with one call.
Read Mastodon, hashtag timelines and search, without building or maintaining a scraper. Same response shape as every other platform here, so one parser handles all of them.
1 credit a call
50 free credits on signup, no card
failed calls: 0 credits
50 free credits on signup, no card
failed calls: 0 credits
1The call
curl -H "x-api-key: $SS_KEY" \ "https://api.socialsearchapi.com/v1/mastodon/tag?query=opensource"
This call costs 1 credit. A new account starts with 50 free credits on any platform: create a key in the dashboard and this command runs as-is.
2Why not build this yourself
Mastodon is federated, so there is no single index - what you can see depends on which instance you ask and what it has federated. Full-text search also requires an authenticated token on most instances.
3What comes backcaptured 2026-08-27
{
"success": true,
"platform": "mastodon",
"data": {
"total": 3,
"items": [
{
"id": "117168549311098541",
"platform": "mastodon",
"type": "post",
"text": "LWDW # Linux fun this week! 🤗💖🐧🐧🐧 Linux celebrates 35 years! 🎉 🐧 Soulcalibur II Linux port, Happy 30th Valve! 🥳 UEFI...",
"url": "https://mast.linuxgamecast.com/@Jill_linuxgirl/117168549276801629",
"author": "Jill_linuxgirl@mast.linuxgamecast.com",
"author_name": "Jill Bryant Ryniker",
"created_at": "2026-08-27T17:02:58Z",
"metrics": {
"comments": 0,
"likes": 0,
"reposts": 1
}
}
]
},
"credits_used": 1
}Items from Mastodon carry: author, author_name, created_at, extra, id, metrics, platform, text, type, url.
4Characteristics
| Parameter | Value |
|---|---|
| /v1/mastodon/search | 1 credit a call |
| /v1/mastodon/tag | 1 credit a call |
| Typical latency | 510 ms, measured 2026-08-27 |
| Coverage | Public posts visible to the instance we query. Federation gaps are inherent. |
| Data | Publicly available content only, nothing behind a login. See the public data notice. |
| Reference | Every Mastodon endpoint, its parameters and its price: API reference |
5Other platforms
Get a key50 free credits · no card