Skip to main content
NEW AI Studio is now available Try it now
Social Verified

Mastodon Scraper

Extract toots, user profiles, instance info, and federated timeline data from Mastodon servers. Powered by spider-browser .

Get Started Documentation
mastodon.social target
99.9% success rate
~4ms latency
Quick Start

Extract data in minutes

mastodon-scraper.ts
import { SpiderBrowser } from "spider-browser";

const spider = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
  stealth: 2,
});

await spider.connect();
const page = spider.page!;
await page.goto("https://mastodon.social/explore");
await page.content(10000);

const data = await page.evaluate(`(() => {
  const toots = [];
  document.querySelectorAll(".status__wrapper").forEach(el => {
    const author = el.querySelector(".display-name__account")?.textContent?.trim();
    const text = el.querySelector(".status__content")?.textContent?.trim();
    const time = el.querySelector("time")?.getAttribute("datetime");
    const boosts = el.querySelector(".status__action-bar__counter:nth-child(2)")?.textContent?.trim();
    if (text) toots.push({ author, text: text.slice(0, 500), time, boosts });
  });
  return JSON.stringify({ total: toots.length, toots: toots.slice(0, 10) });
})()`);

console.log(JSON.parse(data));
await spider.close();
✓ ready to run | spider-browser | TypeScript
Fetch API

Structured data endpoint

Extract structured JSON from mastodon.social with a single POST request. AI-configured selectors, cached for fast repeat calls.

POST /fetch/mastodon.social/
Toot textAuthorBoostsFavoritesRepliesInstance
curl
curl -X POST https://api.spider.cloud/fetch/mastodon.social/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'
Python
import requests

resp = requests.post(
    "https://api.spider.cloud/fetch/mastodon.social/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"return_format": "json"},
)
print(resp.json())
Node.js
const resp = await fetch("https://api.spider.cloud/fetch/mastodon.social/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ return_format: "json" }),
});
const data = await resp.json();
console.log(data);
Extraction

Data you can extract

Toot textAuthorBoostsFavoritesRepliesInstanceTimestampMedia
Stealth

Platform bypass

Residential proxies and fingerprint rotation for mastodon.social access.

Rendering

SPA rendering

Full JavaScript execution for React-based feeds and dynamic content.

Data

Profile & post data

Extract public profiles, posts, engagement metrics, and connections.

Related

More Social scrapers

Start scraping mastodon.social

Get your API key and start extracting data in minutes.