What it returns
Mastodon posts by account (user@instance) or hashtag, trending posts, hashtags and links, profiles and account search, from each instance's public REST API. No login.
Charged per row returned.
Request
POST https://api.pushbuild.com/mastodon-scraper/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: accountPosts, hashtag, trendingPosts, trendingTags, trendingLinks, profiles, searchAccounts | What to fetch. Default: "accountPosts". |
accounts | list of strings | user@instance, e.g. Gargron@mastodon.social (posts and profiles modes). |
hashtags | list of strings | Without #, e.g. nvidia (hashtag mode; read from the chosen instance). |
instance | string | Instance for hashtag, trends and search modes. Default: "mastodon.social". |
query | string | Search accounts mode. |
since | string | ISO date or time; older posts are skipped. |
includeReplies | boolean | Posts by account: include replies. Default: false. |
includeBoosts | boolean | Include boosted (reblogged) posts. Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/mastodon-scraper/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.32 per 1,000 rows. No charge for errors or empty searches.
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/mastodon-scraper. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comNeed data from a site with no API? Web scraping and data pipelines