Mastodon Scraper: Profiles, Posts & Hashtags

Collect public Mastodon profiles, posts and hashtag timelines via the official API, with no login, no browser and no code. Export to JSON, CSV or Excel, or use the API.

Collect public Mastodon profiles (followers, bio, verified links) and posts (text, boosts, favourites, replies, hashtags, media) from any instance through the official Mastodon API. Track accounts or hashtags, filter replies/boosts and dates, and monitor for new posts. Honors users' noindex (opt-out) setting.

Use cases

• Track brand, competitor or influencer accounts
• Hashtag monitoring for events and topics
• Pair with Bluesky data for open-social listening

Input

Field	Type	Notes
accounts	array	@user@instance or a profile URL.
hashtags	array	Read the instance's public hashtag timeline.
hashtagInstance	string
maxPostsPerSource	integer	0 = profiles only.
excludeReplies	boolean
excludeBoosts	boolean
sinceDate	string	YYYY-MM-DD.
monitorMode	boolean	Remember newest post per source; later runs return only newer posts.
stateStoreName	string

Example input

{
 "accounts": [
  "@Mastodon@mastodon.social",
  "https://fosstodon.org/@fosstodon",
  "@nosuchuser-zq81x@mastodon.social"
 ],
 "hashtags": [
  "opensource"
 ],
 "maxPostsPerSource": 3,
 "monitorMode": true
}

Output

One dataset item per result. Main columns: type, author, createdAt, text, repliesCount, reblogsCount, favouritesCount, followers, url, isNew, error. A RUN_SUMMARY record is saved to the default key-value store. See the sample output in the Output tab.

Example output

{
  "type": "profile",
  "input": "@Mastodon@mastodon.social",
  "instance": "mastodon.social",
  "id": "13179",
  "acct": "Mastodon@mastodon.social",
  "displayName": "Mastodon",
  "url": "https://mastodon.social/@Mastodon",
  "bio": "Our mission is to connect the world through thriving online communities.\nThis is the primary account for th...",
  "followers": 878918,
  "following": 51,
  "postsCount": 565,
  "lastPostAt": "2026-10-09",
  "createdAt": "2016-11-23T00:00:00.000Z",
  "bot": false,
  "locked": false,
  "discoverable": true,
  "noindex": false,
  "fields": [
    {
      "name": "Homepage",
      "value": "https://joinmastodon.org",
      "verified": true
    },
    {
      "name": "Source Code",
      "value": "https://github.com/mastodon",
      "verified": true
    },
    {
      "name": "Blog",
      "value": "https://blog.joinmastodon.org",
      "verified": true
    }
  ]
}

Pricing

Pay per result, with no monthly rental or subscription:

• Profile: $0.002
• Post: $0.0004

Example: 1,000 results cost about $2.00 in fees. Apify's free plan includes $5 of monthly credit, which is enough to test this Actor.

FAQ

Do I need an account, cookies or a login for the source site? No. Mastodon Scraper uses public data sources only, so there is nothing to connect and no account to risk.

How much will a run cost? You pay only for results delivered (see Pricing above), plus Apify platform usage, which the free plan's monthly credit easily covers for test runs. Start with a small limit to see the exact cost per run.

Can I export to CSV, Excel or Google Sheets? Yes. Every run's dataset can be downloaded as JSON, CSV, Excel, XML or HTML, or pushed to Google Sheets, Make, Zapier, n8n, Slack or a webhook through Apify integrations.

Can I run it on a schedule or from my own code? Yes. Add an Apify Schedule (hourly, daily, weekly) or call it through the Apify API / Python & JavaScript clients. It also works with AI agents through the Apify MCP server.

What happens if an input is invalid or a source is down? The run keeps going. The bad input gets a row with an error field so you can see what failed, and you are not charged for results that were not delivered.

Is this legal to use? It collects publicly available data. You are responsible for using the output in line with the source's terms and privacy laws such as GDPR/CCPA; don't use it for spam.

Something missing or broken? Open an issue on the Issues tab. Feature requests are usually added within a few days.

Scheduling / monitoring

Create a Schedule (daily/weekly) and connect a webhook or Slack/email integration.

Fair use

Official public APIs only, no login. Do not use output for spam or harassment. Respect the data sources' rate limits and terms.

Related tools

• Bluesky Scraper: Profiles, Posts, Engagement & Followers
• Lemmy Scraper: Communities, Posts, Comments & Search
• Website Contact Details Extractor: Emails, Phones & Socials
• RSS & Atom Feed Reader, Keyword Filter & New Item Monitor

REST API

GET https://api.mediaprotools.com/v1/mastodon-posts?items=... (header X-API-Key). Up to 5 items per call, separated by ,. Or POST {"items":[...],"options":{...}}.

Parameter	Type	Notes
items	token	Read the instance's public hashtag timeline.
accounts	array	@user@instance or a profile URL.
hashtagInstance	string	Hashtag instance
maxPostsPerSource	integer 0-100	0 = profiles only.
excludeReplies	boolean	Exclude replies
excludeBoosts	boolean	Exclude boosts
sinceDate	string	YYYY-MM-DD.

Output fields: author, authorName, card, createdAt, editedAt, favouritesCount, hashtags, id, inReplyToId, input, instance, isBoost, isNew, language, media, mentions, reblogsCount, repliesCount, sensitive, spoilerText, text, type, url, visibility.