# Mastodon Scraper (`anyxsolutions/mastodon-scraper`) Actor
Scrape Mastodon from any server: hashtag timelines, profiles, single posts with their replies, and trending posts, hashtags and news links. Post text, media, engagement counts, authors, polls and boosts as clean JSON. No login, no API key, no proxy.
- **URL**: https://apify.com/anyxsolutions/mastodon-scraper.md
- **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community)
- **Categories:** Social media, News
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## Mastodon Scraper
**Scrape Mastodon posts from any server — hashtags, profiles, threads and trends — as clean JSON, with no login.**
Scrape Mastodon from any server: hashtag timelines, profiles, single posts with their replies, and
trending posts, hashtags and news links. Paste a page from mastodon.social, fosstodon.org,
hachyderm.io or any other Mastodon server, or just type hashtags. Each post comes with its text as
HTML and plain text, content warning, language, replies, boosts and favourites, the author's handle
and follower counts, images and videos with their alt text, hashtags, mentions, link preview, poll
results, and the original post when it is a boost. There is no login, no API key, and no proxy to
configure. Built for social-listening and brand teams, researchers studying the fediverse, journalists
and community managers.
### ⚡ Quick start
```json
{
"startUrls": [
{ "url": "https://mastodon.social/tags/photography" },
{ "url": "https://mastodon.social/@Mastodon" }
],
"hashtags": ["opensource"],
"maxItems": 5
}
```
### 🧩 Input
| Field | Type | Required | Default | Description |
| -------------------- | ------- | -------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `startUrls` | array | no | — | Public pages from any Mastodon server: a hashtag (`https://mastodon.social/tags/photography`), a profile (`https://mastodon.social/@Mastodon`, or a remote one such as `https://mastodon.social/@kev@fosstodon.org`), a single post (`https://mastodon.social/@Mastodon/117411420916699261`), trending posts, hashtags or links (`/explore`, `/explore/tags`, `/explore/links`), or a server's live timeline (`/public/local`, `/public`). |
| `hashtags` | array | no | — | Hashtags to scrape on the server below, one per line, with or without the `#`, for example `opensource` or `#photography`. |
| `instance` | string | no | `mastodon.social` | Server for hashtags: the Mastodon server whose hashtag timelines the hashtags are read from, for example `fosstodon.org` or `hachyderm.io`. |
| `includeReplies` | boolean | no | `false` | Include replies: for a single post URL, also return the replies under it; for a profile URL, also return the account's replies to other people. |
| `maxItems` | integer | no | — | Maximum number of items per start URL or hashtag. The input form starts at 5; leave it empty to get everything the server shares. |
| `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Proxy settings. Mastodon needs no proxy. |
Add URLs, hashtags, or both. A profile on another server, such as `https://mastodon.social/@kev@fosstodon.org`,
is read from the account's own server, which holds its full history. Hashtags, `/explore` and `/public` pages
show what the server in the URL knows about, so the same hashtag can return different posts on different servers.
### 📤 Output
Every row carries an `itemType`. Hashtag, profile, post and timeline URLs, and `/explore`, return `post` rows,
newest first (trending posts in trending order). `/explore/tags` returns trending hashtags as `tag` rows and
`/explore/links` returns trending news stories as `link` rows.
#### Fields
| Field | Type | Description |
| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `itemType` | string | `post`, `tag` or `link`. |
| `id` | string | Post rows: post ID on the server it was read from. Tag rows: hashtag ID. |
| `url` | string | Post rows: the post's page on its origin server. Tag rows: the hashtag page. Link rows: the news story. |
| `uri` | string | Post rows: the post's permanent fediverse identifier. |
| `createdAt` | string | Post rows: ISO time the post was published. |
| `editedAt` | string | Post rows: ISO time of the last edit, or `null`. |
| `language` | string | Language code of the post or story, e.g. `en`, or `null`. |
| `contentHtml` | string | Post rows: post body as HTML, or `null` (boosts carry it in `reblog`). |
| `contentText` | string | Post rows: post body as plain text, with full links and paragraph breaks. |
| `spoilerText` | string | Post rows: the content warning shown before the post, or `null`. |
| `sensitive` | boolean | Post rows: `true` when the media is marked sensitive. |
| `visibility` | string | Post rows: `public` or `unlisted`. |
| `inReplyToId` | string | Post rows: ID of the post this one replies to, or `null`. |
| `repliesCount` | integer | Post rows: number of replies. |
| `reblogsCount` | integer | Post rows: number of boosts. |
| `favouritesCount` | integer | Post rows: number of favourites. |
| `account` | object | Post rows: the author as `{ id, acct, displayName, url, followersCount, followingCount, statusesCount, bot, avatar }`; `acct` is the full handle, e.g. `Mastodon@mastodon.social`. |
| `mediaAttachments` | array | Post rows: images, videos and audio as `{ type, url, previewUrl, description }`; `description` is the alt text. |
| `tags` | array | Post rows: hashtags used in the post, lower-case, without `#`. |
| `mentions` | array | Post rows: mentioned accounts as `{ acct, url }`. |
| `card` | object | Post rows: link preview as `{ url, title, description, image }`, or `null`. |
| `poll` | object | Post rows: `{ id, expiresAt, expired, multiple, votesCount, votersCount, options: [{ title, votesCount }] }`, or `null`. |
| `reblog` | object | Post rows: when the row is a boost, the original post with the same fields; otherwise `null`. |
| `instance` | string | The server the row was read from, e.g. `mastodon.social`. |
| `name` | string | Tag rows: the hashtag, without `#`. |
| `usesLastWeek` | integer | Tag and link rows: posts using the hashtag or sharing the link over the last 7 days. |
| `accountsLastWeek` | integer | Tag and link rows: accounts using the hashtag or sharing the link over the last 7 days. |
| `history` | array | Tag and link rows: daily `{ date, uses, accounts }`, newest first. |
| `title` | string | Link rows: the story's headline. |
| `description` | string | Link rows: the story's summary. |
| `providerName` | string | Link rows: the publisher, e.g. `The Guardian`. |
| `authorName` | string | Link rows: the story's author, or `null`. |
| `image` | string | Link rows: the story's preview image. |
| `publishedAt` | string | Link rows: ISO time the story was published, or `null`. |
Example output
```json
[
{
"itemType": "post",
"id": "117411420916699261",
"url": "https://mastodon.social/@Mastodon/117411420916699261",
"uri": "https://mastodon.social/users/Mastodon/statuses/117411420916699261",
"createdAt": "2026-10-09T14:28:25.298Z",
"editedAt": null,
"language": "en",
"contentHtml": "New #Plushtodon colours now available for pre-orders on our shop! This is a way to support our work and get a squishy friend at the same time.
https://blog.joinmastodon.org/2026/10/plushtodon-pre-orders-now-open/
#Merchtodon
",
"contentText": "New #Plushtodon colours now available for pre-orders on our shop! This is a way to support our work and get a squishy friend at the same time.\n\nhttps://blog.joinmastodon.org/2026/10/plushtodon-pre-orders-now-open/\n\n#Merchtodon",
"spoilerText": null,
"sensitive": false,
"visibility": "public",
"inReplyToId": null,
"repliesCount": 15,
"reblogsCount": 126,
"favouritesCount": 156,
"account": {
"id": "13179",
"acct": "Mastodon@mastodon.social",
"displayName": "Mastodon",
"url": "https://mastodon.social/@Mastodon",
"followersCount": 878925,
"followingCount": 51,
"statusesCount": 565,
"bot": false,
"avatar": "https://files.mastodon.social/accounts/avatars/000/013/179/original/b4ceb19c9c54ec7e.png"
},
"mediaAttachments": [],
"tags": ["plushtodon", "merchtodon"],
"mentions": [],
"card": {
"url": "https://blog.joinmastodon.org/2026/10/plushtodon-pre-orders-now-open/",
"title": "Plushtodon pre-orders now open",
"description": "They're small, they're soft, they're squishy, and they are your friend! If you missed out on our stuffed toys before, now is your chance to pre-order our latest series in Matcha Baku and Hitori Pink.",
"image": "https://files.mastodon.social/cache/preview_cards/images/210/210/286/original/30d703e6eed07ce8.jpg"
},
"poll": null,
"reblog": null,
"instance": "mastodon.social"
},
{
"itemType": "tag",
"id": "21533570",
"name": "DontAskASong",
"url": "https://mastodon.social/tags/dontaskasong",
"usesLastWeek": 234,
"accountsLastWeek": 67,
"history": [
{
"date": "2026-10-13",
"uses": 0,
"accounts": 0
},
{
"date": "2026-10-12",
"uses": 234,
"accounts": 67
},
{
"date": "2026-10-11",
"uses": 0,
"accounts": 0
},
{
"date": "2026-10-10",
"uses": 0,
"accounts": 0
},
{
"date": "2026-10-09",
"uses": 0,
"accounts": 0
},
{
"date": "2026-10-08",
"uses": 0,
"accounts": 0
},
{
"date": "2026-10-07",
"uses": 0,
"accounts": 0
}
],
"instance": "mastodon.social"
}
]
```