Mastodon Scraper

hipersoft/mastodon-scraper

Scrape public Mastodon posts by hashtag or account from any instance: post text, author, followers, favourites, boosts, replies, tags, media and date. One clean row per post as JSON, CSV or Excel.

Run this scraper →See the API call

Total users

Monthly users

Total runs

Per post scraped

$0.0015

Last rebuilt

Oct 26, 2026

Overview

Scrape public Mastodon posts by hashtag or account from any instance. Get one clean row per post — text, author, follower count, favourites, boosts, replies, tags, media and date. Export to JSON, CSV or Excel, or pull straight from the API.

Perfect for social listening, hashtag and trend tracking, community and competitor analysis, fediverse research, and building post datasets for dashboards or LLMs.

What you get

One flat, ready-to-use record per post:

Field	Description
`id` / `url`	The post and its link
`content`	Post text (HTML stripped)
`author` / `authorName`	Handle and display name
`authorFollowers`	Author's follower count
`favourites` / `reblogs` / `replies`	Engagement metrics
`tags`	Hashtags on the post
`mediaUrls`	Attached media
`language` / `sensitive`	Post metadata
`isReblog` / `rebloggedBy`	Boost info (content is the boosted post's)
`createdAt`	Publish date (ISO 8601)
`instance` / `source`	Where and how it was collected
`collectedAt`	When the row was scraped

How to use

1. By hashtag or account

{
  "instance": "mastodon.social",
  "hashtags": ["technology", "opensource"],
  "accounts": ["Gargron"],
  "maxItems": 300
}

Instance — the Mastodon server to query (it federates results across the network) — e.g. mastodon.social, fosstodon.org, infosec.exchange.
Hashtags — public posts for each tag.
Accounts — posts from given handles (user or [email protected]).
Max posts — cap the total (0 = no limit; the scraper pages through results).

Example output

{
  "id": "117304350090200688",
  "url": "https://mastodon.social/@techwire/117304350090200688",
  "content": "One-Electron Universe — great read on…",
  "author": "[email protected]",
  "authorFollowers": 258,
  "favourites": 12,
  "reblogs": 1,
  "replies": 0,
  "tags": ["tech", "technology", "technews"],
  "isReblog": false,
  "createdAt": "2026-09-20T15:40:00.000Z",
  "collectedAt": "2026-09-20T16:20:00.000Z"
}

Common use cases

Social listening — track what's said around a topic or hashtag on the fediverse.
Trend tracking — monitor hashtags over time.
Community & competitor analysis — follow accounts' posts and engagement.
Fediverse research — gather public posts across instances.
Datasets — build clean, structured post corpora for analysis or model training.

Frequently asked questions

Do I need any login, account or key? No. Just set hashtags or accounts and run.

Can I use a different instance? Yes — set the Instance field to any Mastodon server.

Can I scrape a specific person's posts? Yes — add their handle (e.g. user@instance) to Accounts.

How many posts can I get? Set Max posts to whatever you need (0 = no limit) — the scraper pages through the timeline.

What format is the data? A flat table you can export as JSON, CSV or Excel, or fetch from the Apify API.

Related scrapers

Building a social toolkit? Check out our other social media scrapers on Apify Store — all with the same clean, one-row-per-item output.

Input

Field	Type	Description
`instance` Instance	string	The Mastodon instance to query — e.g. 'mastodon.social', 'infosec.exchange', 'fosstodon.org'. Hashtag and account lookups run against this instance (it federates results from across the network). Default: `"mastodon.social"`
`hashtags` Hashtags	array	Hashtags to scrape public posts for — e.g. 'technology', 'opensource', 'photography' (with or without #).
`accounts` Accounts	array	Account handles to scrape posts from — e.g. 'Gargron' or '[email protected]'.
`maxItems` Max posts	integer	Maximum number of posts to collect across all hashtags and accounts (0 = no limit). Default: `100`

API

curl -X POST "https://api.apify.com/v2/acts/hipersoft~mastodon-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "hashtags": [
    "technology"
  ]
}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/mastodon-scraper").call(run_input={
    "hashtags": [
        "technology"
    ]
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/mastodon-scraper').call({
  "hashtags": [
    "technology"
  ]
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

Event	Price	Paid plans from
Post scraped Charged for each Mastodon post returned.	$0.0015	$0.0008

You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.

Related scrapers

Website Contact Scraper

Extract business emails, phone numbers and social media profiles from any list of websites. De-obfuscates emails, reads Organization schema, and optionally crawls contact/about pages. Bulk-ready.

1,576 runs · 69 users · $0.0024 / website scraped

Threads Downloader

Download Threads photos, videos and carousel posts by URL. Paste threads.net or threads.com links and get ready-to-use download links plus direct media URLs, a thumbnail, media type and count — one row per URL as JSON, CSV or Excel. Cheap, bulk, built for creators and n8n.

799 runs · 4 users · $0.003 / post downloaded

TikTok Video Downloader

Download TikTok videos without watermark in bulk. Paste video or photo-slideshow URLs and get a clean HD MP4 download link plus full metadata: caption, author, play/like/comment/share counts, sound and cover — one row per post as JSON, CSV or Excel. For creators, research and n8n.

678 runs · 9 users · $0.0035 / video downloaded

Reddit Scraper

Scrape Reddit posts and comments by subreddit, keyword, author or thread URL. Get titles, self-text, scores, upvote ratio, comment counts, comment trees and permalinks — one clean row per post or comment. Export as JSON, CSV or Excel.

568 runs · 15 users · $0.0034 / post scraped

Spotify Scraper

Search Spotify and scrape public metadata for tracks, artists, albums and playlists: names, artists, popularity, followers, genres, release dates, duration, ISRC, preview URL and more. No Spotify login or API key required. For music research, catalogs and analytics.

478 runs · 9 users · $0.0034 / item scraped

Reddit Video, Image & GIF Downloader

Download Reddit videos, images and GIFs by post URL. Paste reddit.com or redd.it links and get ready-to-use download links — videos as a single playable MP4 with audio, images and galleries as direct links — one row per URL as JSON, CSV or Excel. Cheap, bulk, built for creators and n8n.

453 runs · 16 users · $0.003 / item scraped

Need a source that isn't here?

Send the site and the fields. We build it and you get it first.

Request a build