Mastodon Scraper
Mastodon scraper for hashtags, accounts, trending tags and links, and replies across several instances. No API key, no login, no proxy: official open Mastodon API. Only-new mode turns it into a brand and keyword monitor for the fediverse. $0.80 per 1000 results.
Example request
curl -X POST https://radarbg.com/v1/mastodon-hashtag-monitor \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"instances": ["mastodon.social"], "hashtags": ["python"], "maxItems": 50, "includeTrends": false}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
instances | array | Mastodon servers to read from, for example mastodon.social or fosstodon.org. Hashtag posts are read from each instance's public timeline, so more instances give wider coverage. Accounts without a server use the first instance. |
hashtags | array | Hashtags to read, with or without the # sign, for example python or opensource. Each hashtag is read on every instance listed above. |
accounts | array | Accounts whose public posts you want, as user@server (Gargron@mastodon.social) or a profile URL (https://mastodon.social/@Gargron). Boosts and replies are left out. |
keywords | array | Optional. Keep only posts whose text contains any of these words or phrases (not case sensitive). Mastodon has no public full-text search, so keywords filter the posts fetched from your hashtags and accounts. |
language | string | Optional. Keep only posts written in this language, for example en, de or bg. Empty = all languages. |
maxItems | integer | Hard limit on rows saved (and paid for): posts, replies and trend rows together. Posts are shared equally between the hashtags and accounts. |
includeTrends | boolean | Also save the trending hashtags and trending links of every instance, with their usage in the last days. Trend rows are a snapshot and are not affected by only-new mode. |
includeLocalTimeline | boolean | Also read the public local timeline of every instance (posts by that server's own users). Many servers require a login for this and are then skipped with a note in the run summary. |
includeReplies | boolean | Also save the public replies to each post. Each reply is one result. |
maxRepliesPerPost | integer | Replies saved for each post that has replies. |
onlyNew | boolean | Return only posts and replies not returned in earlier runs with the same monitor ID. Schedule the actor to track brands, keywords or hashtags. |
monitorId | string | Name of the memory used by monitoring mode. Use a different ID for each search you track. |
datasetId | string | Optional. Pick a dataset (or paste its ID) to read the input from, for example the result of Google Maps Scraper. When this actor runs as an integration, the dataset of the triggering run is used automatically (payload.resource.defaultDatas |
datasetField | string | Optional. The item field that holds the value, for example website, url or videoUrl (dot paths like author.url work). Empty = detected automatically. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.