Mastodon Account Scraper
Pricing
from $1.00 / 1,000 results
Pricing
from $1.00 / 1,000 results
Rating
0.0
(0)
Developer
Farhan Febrian Nauval
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
6 days ago
Last modified
Categories
Features
Share
Extract public profile data from any Mastodon account across the Fediverse — display name, bio, follower and following counts, status count, profile photo, header image, creation date, bot flag, and locked status — in a clean structured JSON output.
Why use this actor
- Works across any instance —
mastodon.social,mas.to,fosstodon.org,infosec.exchange,hachyderm.io, and every other Mastodon (or ActivityPub-compatible) server, all from the same actor. - No account / no login required — just give it a
user@instance.tldhandle. - Full bio with HTML preserved — links, mentions, and custom emoji markup are kept intact in the
notefield so you can render or parse them downstream. - Bot detection built in — every record exposes the
botflag exactly as the account owner set it, pluslocked(private follow approval) anddiscoverable(opted into directory listings). - Verified profile fields — the four custom fields with their
verified_attimestamps come through unchanged, so you can trust the "verified link" badge. - Stable JSON output suitable for pipelines, spreadsheets, and databases — every row carries
_input,_instance,_source,_scrapedAtenvelope fields so you can join results back to your input list.
How it works
- You provide a list of Mastodon handles in
user@instance.tldformat (e.g.Gargron@mastodon.social). - The actor talks to each account's home instance and reads the public profile record the same way the Mastodon web app does, then assembles a flat JSON record.
- Results stream into your dataset, ready to download as JSON, CSV, or Excel.
You do not need to manage scrapers, instance discovery, or rotating IPs — all handled internally.
Input
{"accounts": ["Gargron@mastodon.social","atomicpoet@mas.to"],"instance": "mastodon.social","proxyConfiguration": {"useApifyProxy": true,"apifyProxyGroups": ["DATACENTER"]}}
| Field | Type | Description |
|---|---|---|
accounts | array | List of Mastodon handles in user@instance.tld form. The instance suffix is what tells the actor where to look — Gargron@mastodon.social and Gargron@mas.to are two different accounts. Full profile URLs (e.g. https://mastodon.social/@Gargron) are also accepted. |
instance | string | Default instance used only when an entry in accounts is a bare username with no @instance suffix. Defaults to mastodon.social. |
accessToken | string | Optional Mastodon API token. Most instances do not need one — provide it only for private or invite-only instances that block anonymous lookups. |
proxyConfiguration | object | Apify Proxy settings. Datacenter proxy works for most cases. |
Output
Input: Gargron@mastodon.social
{"_input": "Gargron@mastodon.social","_instance": "mastodon.social","_source": "S1-api","_scrapedAt": "2026-05-18T11:13:17.515158+00:00","id": "1","username": "Gargron","acct": "Gargron","display_name": "Eugen Rochko","locked": false,"bot": false,"discoverable": true,"indexable": true,"group": false,"created_at": "2016-03-16T00:00:00.000Z","note": "<p>Executive Strategy & Product Advisor, Founder of <span class=\"h-card\">@<span>Mastodon</span></span>. Film photography, prog metal, Dota 2. Likes all things analog.</p>","url": "https://mastodon.social/@Gargron","uri": "https://mastodon.social/users/Gargron","avatar": "https://files.mastodon.social/accounts/avatars/000/000/001/original/a0a49d80c3de5f75.png","avatar_static": "https://files.mastodon.social/accounts/avatars/000/000/001/original/a0a49d80c3de5f75.png","header": "https://files.mastodon.social/accounts/headers/000/000/001/original/d13e4417706a5fec.jpg","header_static": "https://files.mastodon.social/accounts/headers/000/000/001/original/d13e4417706a5fec.jpg","followers_count": 380126,"following_count": 711,"statuses_count": 81382,"last_status_at": "2026-05-17","noindex": false,"emojis": [],"roles": [],"fields": [{ "name": "GitHub", "value": "https://github.com/Gargron", "verified_at": "2023-02-07T23:24:40.347+00:00" },{ "name": "Portfolio", "value": "https://eugenrochko.com", "verified_at": "2024-07-06T01:06:10.801+00:00" },{ "name": "Mastodon Merch", "value": "https://shop.joinmastodon.org", "verified_at": null }]}
| Field | Type | Description |
|---|---|---|
_input | string | The handle exactly as you supplied it. Use this to join results back to your input list. |
_instance | string | The Mastodon instance the record was fetched from (e.g. mastodon.social). Useful for grouping or filtering by server. |
_source | string | Internal tag for the path used to fetch the record. S1-api is the standard public lookup path. |
_scrapedAt | string | ISO-8601 UTC timestamp when the record was scraped. |
id | string | Mastodon's internal numeric account ID on the home instance. Stable across username changes. |
username | string | Local username on the home instance (e.g. Gargron). |
acct | string | Account identifier — bare username when the account is local to the instance you queried, or user@instance.tld when remote. |
display_name | string | Display name set by the user (free-form text, may contain custom emoji shortcodes). |
locked | boolean | true if the account requires manual approval for new followers. |
bot | boolean | true if the account owner has flagged this as an automated / bot account. |
discoverable | boolean | true if the user opted into appearing in the profile directory and recommendations. |
indexable | boolean | true if the user allows search engines to index their statuses. |
group | boolean | true if the account is a Mastodon group account rather than a person. |
created_at | string | ISO-8601 timestamp of when the account was created on its home instance. |
note | string | The bio / about section, with HTML markup preserved (links, mentions, line breaks). |
url | string | Canonical public profile URL on the home instance. |
uri | string | ActivityPub actor URI — the federated identifier used for cross-instance communication. |
avatar | string | URL of the profile picture (animated if the user uploaded a GIF). |
avatar_static | string | URL of the still-frame profile picture. |
header | string | URL of the profile header banner image. |
header_static | string | URL of the still-frame header banner. |
followers_count | integer | Number of accounts following this profile. |
following_count | integer | Number of accounts this profile follows. |
statuses_count | integer | Total number of public statuses (posts) the account has published. |
last_status_at | string | Date of the most recent public status (YYYY-MM-DD). null if the account has never posted. |
noindex | boolean | true if the user opted out of search-engine indexing. |
emojis | array | Custom emoji used in the display name or bio (each item has shortcode, url, static_url). |
roles | array | Public roles assigned by the home instance (e.g. moderator badge). Empty for normal users. |
fields | array | Up to four custom profile fields. Each item has name, value (with HTML), and verified_at — non-null when the link was verified via rel="me". |
Error envelope
Accounts that don't exist, are on an unreachable instance, or are suspended return a structured error instead of crashing the run:
{"_input": "this-user-does-not-exist@mastodon.social","_instance": "mastodon.social","_user": "this-user-does-not-exist","_error": "not_found","_errorDetail": "NotFound: account lookup returned 404","_source": "S1-api","_scrapedAt": "2026-05-18T11:13:18.012345+00:00"}
Common _error values: not_found (suspended, deleted, or never existed), invalid_input (couldn't parse the handle — usually a missing @instance suffix on a bare username with no default set), fetch_failed (instance unreachable or returned a transient error).
Filter on _error to triage failed rows.
Pricing
This actor is billed per result: $1.50 per 1,000 profiles. Each successful profile = 1 result. Errors (not-found, suspended, invalid input) are not billed.
Other Sosmed Actors
| Platform | Actor | Best for |
|---|---|---|
| Mastodon | Mastodon Status Detail Scraper | Full post content, boosts, replies, media |
| Bluesky | Bluesky Account Scraper | atproto profile + counters |
| Threads | Threads Account Scraper | Profile data for a Threads handle |
| Twitter / X | X Account Scraper | Profile + tweet counts for any handle |
| Tumblr | Tumblr Blog Scraper | Blog title, description, post count |
| Reddit User Profile Scraper | Karma, posts, trophies |
Browse the full catalog at apify.com/xtracto.
Notes
- Mastodon is decentralized — the instance matters.
alice@mastodon.socialandalice@mas.toare two different accounts on two different servers. Always include the@instance.tldsuffix in your input (or set theinstancefield for bare usernames). - Rate limits are per-instance. Each Mastodon server enforces its own limits — typically 300 unauthenticated requests per 5 minutes per IP. For large bulk runs against a single instance, enable Apify Proxy rotation.
- Pleroma, Akkoma, GoToSocial, and other forks are mostly compatible. Profile shape may vary slightly (extra fields, missing flags); the core username / display_name / follower counts / bio are always present.
- Counters are eventually-consistent and may lag the live network by a few minutes due to federation delays.
- Private / invite-only instances that have set
DISALLOW_UNAUTHENTICATED_API_ACCESSwill reject anonymous lookups. Provide anaccessTokenfrom that instance to unlock them. - Suspended, deleted, or never-existed accounts return
{"_error": "not_found", "_input": "..."}.