Mastodon Profile Scraper

Mastodon Profile Scraper 🎯

Manually visiting Mastodon profiles to collect account metadata wastes hours you don’t have. Mastodon Profile Scraper pulls profile information from a list of Mastodon handles in bulk, saving you time. This Mastodon profile scraper (and Mastodon user profile scraper) is ideal for marketers, recruiters, and growth teams who need structured data fast. In a single run, you can process many profiles and export results immediately.

---

What You Get: Sample Output

Here's a sample record from a single run:

{
  "id": "123456789012345678",
  "username": "warandpeas",
  "acct": "warandpeas@mastodon.social",
  "display_name": "War and Peas",
  "note": "Open source gardening, small ideas, big grows 🌱",
  "followers_count": 1204,
  "following_count": 88,
  "statuses_count": 532,
  "created_at": "2024-02-10T12:34:56.000Z",
  "url": "https://mastodon.social/@warandpeas",
  "avatar_static": "https://mastodon.social/images/avatar_static.png",
  "header_static": "https://mastodon.social/images/header_static.png",
  "error_message": null,
  "success": true
}

Note: The actor returns the raw Mastodon API account lookup response for each handle, or an error object when a profile can’t be fetched.

Field	Type	What It Tells You
id	string	Stable profile identifier you can use to join datasets
username	string	The visible handle users type when searching or tagging
acct	string	The normalized user@instance account string for accurate matching
display_name	string	The profile’s display name for reports and enrichment
note	string	Bio text you can parse for positioning, interests, or topics
followers_count	number	Social reach estimate for prioritization and scoring
following_count	number	Indicates how engaged or community-focused the account is
statuses_count	number	Activity level (useful for engagement maturity)
created_at	string	Account age for segmentation and trust signals
url	string	Direct profile link for citations and human verification
avatar_static	string	Avatar image URL for creative review or branding workflows
header_static	string	Banner image URL for richer profile snapshots
error_message	string | null	Explains what went wrong when a handle can’t be fetched
success	boolean	Convenient flag to quickly separate successful vs failed results

Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard.

---

Why Mastodon Profile Scraper?

There are a lot of ways to pull data from Mastodon — here’s what sets Mastodon Profile Scraper apart.

Built for handle-based bulk enrichment

Feed in a list of profile_ids (Mastodon handles like Mastodon or dataforleads@gmail.com) and the actor fetches profile metadata for each one so you can build structured datasets quickly. This makes a Mastodon account scraper practical for batch research and ongoing enrichment.

Instance-aware lookups with fallback support

The actor detects the instance from the handle when you pass dataforleads@gmail.com, and it also includes a fallback lookup approach when the first attempt doesn’t succeed. That means fewer “missing profile” gaps when you’re collecting across different instances.

Resilient execution and per-profile error handling

If a profile fails to fetch, the actor returns an error object for that specific profile_id instead of failing the whole run. You still get partial results, which is especially important for Mastodon profile data extraction at scale.

Outputs structured profile metadata for analysis

Results are pushed to your Apify dataset as JSON records as each handle is processed. That keeps the output usable for data analysts, outreach teams, and anyone doing enrichment, segmentation, or downstream automation with a Mastodon profile scraping tool.

---

Configuring Your Run

Drop this into your input.json to get started:

{
  "profile_ids": [
    "Mastodon",
    "warandpeas",
    "user@instance.social"
  ]
}

Parameter	Required	What It Does
profile_ids	✅	A list of Mastodon handles to scrape. Examples include Mastodon and dataforleads@gmail.com.

---

Core Capabilities

Bulk profile processing from a handle list

Mastodon Profile Scraper is designed to turn many handles into many structured results in one run. It’s a straightforward Mastodon profile URL scraper workflow for anyone who needs automated Mastodon profile scraping without manual browsing.

Accurate profile metadata from the Mastodon API

For each handle, the actor fetches profile metadata via Mastodon’s account lookup endpoint. The returned objects include key account details like display name, bio text (note), and follower metrics.

Resilience with clear failure outputs

When a handle can’t be fetched, the actor returns an error object that includes the profile_id and a status-style message. This keeps your Mastodon user profile scraper outputs audit-friendly and easier to debug.

Real-time dataset writing during the run

Results are pushed as they’re processed, so you don’t have to wait for the entire batch to finish before exporting. This makes Mastodon profile crawler runs more dependable for iterative workflows.

Automation-ready for research pipelines

Because outputs are JSON records written to your dataset, you can integrate them into ETL jobs, lead enrichment, or analytics tooling. This is a practical Mastodon API profile scraper approach for repeatable data collection.

---

Who Gets the Most Out of This

Mastodon Profile Scraper helps teams that already have a list of Mastodon accounts and want structured enrichment fast. For example, growth teams can convert handle lists into clean datasets containing bios and follower metrics to prioritize outreach. Community managers can quickly audit who’s active and how the audience is distributed by analyzing follower and posting volume across accounts. Sales development reps can turn discovered Mastodon accounts into organized records they can feed into lead scoring or CRM enrichment workflows. Freelance researchers can use the exported profile metadata as evidence-friendly inputs for reports and segmentation. For developers and data engineers, the consistent dataset output supports automation—pull once, store, and then join with other sources for analysis.

---

Step-by-Step: How to Use It

No coding needed. Here's how to run Mastodon Profile Scraper from start to finish:

1. Open the actor on Apify — start from the actor page and click Run: https://console.apify.com
2. Enter your inputs in profile_ids (a list of Mastodon handles like Mastodon or dataforleads@gmail.com)
3. Configure proxy settings for reliable scraping (recommended for larger batches)
4. Hit Run and watch the live log for progress and any per-profile warnings
5. View results in the dataset tab as records are pushed during processing
6. Export your dataset as JSON, CSV, or Excel directly from the Apify dashboard

The whole process takes under 5 minutes to set up.

---

Integrations & Export Options

Once your data is collected, Mastodon Profile Scraper plugs directly into your existing workflow. Download your results in common formats from the Apify dataset tab (JSON, CSV, Excel), or connect your dataset to other tools via Apify’s native integrations and automation platforms.

You can also use Apify API access to pull results programmatically from your run, and set up webhooks or scheduled runs so your Mastodon profile scraping tool can run automatically when you need fresh data.

---

Pricing & Free Trial

Mastodon Profile Scraper runs on the Apify platform, which offers a free tier — no credit card required to get started. Apify provides free credits for initial experimentation, then you can scale with pay-as-you-go billing based on platform compute usage. For teams running heavier workflows, Apify subscription plans may be available for more predictable scaling. Start for free at apify.com and scale when you’re ready.

---

Reliability & Performance

What We Handle	How
Rate limits and access variability	Uses built-in request handling and proxy support for reliability
Cross-instance handle lookups	Includes fallback logic to improve fetch success across instances
Fetch failures per handle	Returns an error object for the specific profile_id that fails
Batch processing stability	Processes each profile and writes results as it goes for partial-run resilience

Limitations: Mastodon Profile Scraper only retrieves profile metadata that’s accessible through the public Mastodon account lookup process. If a handle can’t be fetched, you’ll see an error object for that profile_id. For enterprise-scale automation, contact us to discuss custom configurations.

For enterprise-scale runs, contact us to discuss custom configurations.

---

Frequently Asked Questions

Is there a free plan or trial?

Yes. Apify offers a free tier with credits for getting started, so you can test Mastodon profile scraper outputs without committing upfront.

Do I need to log in to Mastodon to use this?

No. This actor fetches profile metadata for handles using public account lookup access, so you don’t need a Mastodon login or session.

How accurate is the data?

The data accuracy depends on what the account owner has published in their profile metadata. The actor returns structured results from the account lookup response for each handle, including bios and follower metrics.

How many results can I get per run?

Your results correspond to the number of handles you provide in profile_ids. The actor processes each one and pushes its result to the dataset as it completes.

How often is the data updated / how fresh is it?

Data freshness matches the time you run the actor. If you need updates, schedule or re-run the actor to refresh the profile metadata.

Is this legal? Does it comply with GDPR / CCPA?

You should use the output in a way that complies with applicable laws and platform rules. The actor works with publicly available data, but compliance decisions (including GDPR/CCPA and any consent requirements) are ultimately your responsibility.

Can I export results to Google Sheets or Excel?

Yes. You can export from the Apify dashboard as JSON, CSV, or Excel, and then import into tools like Google Sheets or your preferred spreadsheet/CRM workflow.

Can I run this on a schedule automatically?

Yes. You can use Apify’s scheduling capabilities to run the actor automatically on a cadence you choose, so your Mastodon profile scraping tool keeps data up to date.

Can I access this via API?

Yes. You can trigger and retrieve run results via the Apify API. For details, refer to the Apify API documentation at https://apify.com/docs/api.

What happens if the actor hits an error?

If fetching a specific profile fails, the actor returns an error object for that profile_id while continuing the rest of the run. This way you still get partial results instead of losing everything.

---

Need Help or Have a Request?

Got a question about Mastodon Profile Scraper or want a new feature added? Reach out at dataforleads@gmail.com. Share what you’re trying to build (for example, exporting to a specific format or adding an enrichment step), and we’ll respond with guidance. This actor is actively maintained based on user feedback—send your request and we’ll take a look.

---

Disclaimer & Responsible Use

Mastodon Profile Scraper is the fastest, most reliable way to collect Mastodon profile metadata at scale — start your free run today.

This actor collects publicly available data from Mastodon profile lookups. It does not access private accounts, login-gated content, or password-protected pages. You’re responsible for using the data in compliance with GDPR, CCPA, platform Terms of Service, and any applicable local regulations. For data-removal requests, contact dataforleads@gmail.com. Use responsibly, ethically, and only for lawful purposes.