Mastodon extraction API

Mastodon Scraper - Extract Public Posts

Extract public Mastodon statuses from compatible instances into clean Markdown or normalized post JSON.

Try it free No account needed

Live playground

Try Mastodon extraction.

Use an example or paste your own public URL. The playground calls the same cacheable GET API your agent will use.

Result

Open raw

Supported inputs

Built for normal public URLs.

Public status pages on compatible instances
Local and federated public accounts
Content warnings and media descriptions
Markdown and normalized JSON

Clear boundaries

Know exactly what to expect.

No private, followers-only, deleted, or unavailable posts
No timelines, complete threads, replies, or media downloads
Instances can disable compatible public access

One GET request

Add Mastodon data to your agent.

No SDK and no account are required during the public preview. Choose JSON for typed entities or Markdown for direct model context.

Read the quickstart

curl --get 'https://extractor.sh/api/extract' \
  --data-urlencode 'url=https://mastodon.social/@trwnh/99664077509711321' \
  --data-urlencode 'format=json'

const params = new URLSearchParams({
  url: 'https://mastodon.social/@trwnh/99664077509711321',
  format: 'json',
});

const response = await fetch(
  `https://extractor.sh/api/extract?${params}`,
);
const data = await response.json();

from json import load
from urllib.parse import urlencode
from urllib.request import urlopen

params = urlencode({
    "url": "https://mastodon.social/@trwnh/99664077509711321",
    "format": "json",
})

with urlopen(f"https://extractor.sh/api/extract?{params}") as response:
    data = load(response)

Common questions

Mastodon scraper FAQ

What Mastodon URLs can extractor.sh process?

Public posts. Use an ordinary public URL from the platform.

What does the Mastodon extraction API return?

One source-linked post from a compatible public instance. Choose raw Markdown or schema-versioned JSON for every request.

What are the limits of Mastodon extraction?

No private, followers-only, deleted, or unavailable posts. No timelines, complete threads, replies, or media downloads. Instances can disable compatible public access.

More sources