Skip to main content gottem  — one API for every scraper.
Social
Verified

Mastodon Scraper

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

Get started Docs
target
mastodon.social
success rate
99.9%
latency
~4ms
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

One endpoint for mastodon.social.

Structured JSON from mastodon.social with a single POST. AI-resolved selectors, cached on the first call.

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

Fields you can pull.

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

Start scraping mastodon.social.

Grab an API key and call the endpoint above. The first request resolves the config; every request after hits cache.