Mastodon Account Scraper avatar

Mastodon Account Scraper

Pricing

from $1.00 / 1,000 results

Go to Apify Store
Mastodon Account Scraper

Mastodon Account Scraper

Get Mastodon account metadata from any instance.

Pricing

from $1.00 / 1,000 results

Rating

0.0

(0)

Developer

Farhan Febrian Nauval

Farhan Febrian Nauval

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

6 days ago

Last modified

Features

Limited permissions

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.tld handle.
  • Full bio with HTML preserved — links, mentions, and custom emoji markup are kept intact in the note field so you can render or parse them downstream.
  • Bot detection built in — every record exposes the bot flag exactly as the account owner set it, plus locked (private follow approval) and discoverable (opted into directory listings).
  • Verified profile fields — the four custom fields with their verified_at timestamps 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, _scrapedAt envelope fields so you can join results back to your input list.

How it works

  1. You provide a list of Mastodon handles in user@instance.tld format (e.g. Gargron@mastodon.social).
  2. 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.
  3. 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"]
}
}
FieldTypeDescription
accountsarrayList 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.
instancestringDefault instance used only when an entry in accounts is a bare username with no @instance suffix. Defaults to mastodon.social.
accessTokenstringOptional Mastodon API token. Most instances do not need one — provide it only for private or invite-only instances that block anonymous lookups.
proxyConfigurationobjectApify 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 &amp; 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 }
]
}
FieldTypeDescription
_inputstringThe handle exactly as you supplied it. Use this to join results back to your input list.
_instancestringThe Mastodon instance the record was fetched from (e.g. mastodon.social). Useful for grouping or filtering by server.
_sourcestringInternal tag for the path used to fetch the record. S1-api is the standard public lookup path.
_scrapedAtstringISO-8601 UTC timestamp when the record was scraped.
idstringMastodon's internal numeric account ID on the home instance. Stable across username changes.
usernamestringLocal username on the home instance (e.g. Gargron).
acctstringAccount identifier — bare username when the account is local to the instance you queried, or user@instance.tld when remote.
display_namestringDisplay name set by the user (free-form text, may contain custom emoji shortcodes).
lockedbooleantrue if the account requires manual approval for new followers.
botbooleantrue if the account owner has flagged this as an automated / bot account.
discoverablebooleantrue if the user opted into appearing in the profile directory and recommendations.
indexablebooleantrue if the user allows search engines to index their statuses.
groupbooleantrue if the account is a Mastodon group account rather than a person.
created_atstringISO-8601 timestamp of when the account was created on its home instance.
notestringThe bio / about section, with HTML markup preserved (links, mentions, line breaks).
urlstringCanonical public profile URL on the home instance.
uristringActivityPub actor URI — the federated identifier used for cross-instance communication.
avatarstringURL of the profile picture (animated if the user uploaded a GIF).
avatar_staticstringURL of the still-frame profile picture.
headerstringURL of the profile header banner image.
header_staticstringURL of the still-frame header banner.
followers_countintegerNumber of accounts following this profile.
following_countintegerNumber of accounts this profile follows.
statuses_countintegerTotal number of public statuses (posts) the account has published.
last_status_atstringDate of the most recent public status (YYYY-MM-DD). null if the account has never posted.
noindexbooleantrue if the user opted out of search-engine indexing.
emojisarrayCustom emoji used in the display name or bio (each item has shortcode, url, static_url).
rolesarrayPublic roles assigned by the home instance (e.g. moderator badge). Empty for normal users.
fieldsarrayUp 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

PlatformActorBest for
MastodonMastodon Status Detail ScraperFull post content, boosts, replies, media
BlueskyBluesky Account Scraperatproto profile + counters
ThreadsThreads Account ScraperProfile data for a Threads handle
Twitter / XX Account ScraperProfile + tweet counts for any handle
TumblrTumblr Blog ScraperBlog title, description, post count
RedditReddit User Profile ScraperKarma, posts, trophies

Browse the full catalog at apify.com/xtracto.

Notes

  • Mastodon is decentralized — the instance matters. alice@mastodon.social and alice@mas.to are two different accounts on two different servers. Always include the @instance.tld suffix in your input (or set the instance field 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_ACCESS will reject anonymous lookups. Provide an accessToken from that instance to unlock them.
  • Suspended, deleted, or never-existed accounts return {"_error": "not_found", "_input": "..."}.