# Mastodon Posts Scraper - Low-cost💲🔥📢🐘 (`delectable_incubator/mastodon-posts-scraper-low-cost`) Actor

🔎 Extract Mastodon posts and profile insights with ease. Collect author details, post content, hashtags, engagement metrics, media attachments, external links, publication dates, and post URLs. Ideal for OSINT research, trend analysis and decentralized social media monitoring 📊🚀

- **URL**: https://apify.com/delectable\_incubator/mastodon-posts-scraper-low-cost.md
- **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community)
- **Categories:** Lead generation, Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

<p align="center">
  <img src="https://i.ibb.co/jkNS73wX/readme.png" alt="Mastodon Profile Posts Scraper" width="100%">
</p>

---

## 🐘📢 Mastodon Profile Posts Scraper | Bulk Mastodon Posts Scraper | Apify Actor

### 🚀 Extract Mastodon Profile Posts in Seconds (No Code)

The **Mastodon Profile Posts Scraper (Apify Actor)** is a powerful, scalable and **SEO-optimized Mastodon scraping tool** designed to extract posts from Mastodon profiles across any public instance.

Easily **scrape Mastodon posts in bulk**, collect engagement metrics, hashtags, media attachments, author information and export structured datasets for **OSINT, social media monitoring, audience research, AI datasets, trend analysis and brand intelligence**.

---

### 🔥 Why This Mastodon Scraper?

✔ Best Mastodon Profile Posts Scraper on Apify

✔ Supports **bulk profile URL scraping**

✔ Works across multiple Mastodon instances

✔ Fast & scalable extraction engine

✔ Structured JSON / CSV / Excel output

✔ Perfect for OSINT & social listening

✔ Ideal for researchers, marketers & analysts

✔ No coding required

---

### 🎯 What This Scraper Does (Mastodon Posts Data Extraction)

This Apify Actor extracts **real-time posts from Mastodon profile timelines**.

#### 📌 Core Features

✅ Scrape Mastodon profile posts

✅ Bulk URL scraping mode (SEO BOOST 🚀)

✅ Supports any public Mastodon instance

✅ Extract post content & metadata

✅ Extract favourites, boosts & replies

✅ Extract hashtags & mentions

✅ Extract images, videos & media attachments

✅ Extract author profile information

✅ Auto scrolling & pagination handling

✅ Clean structured dataset output

✅ High-speed extraction engine

---

### ⚡ Input Configuration (Simple & Powerful)

#### 🔥 BULK URL MODE (SEO BOOST 🚀)

````

{
"urls": \[
"https://mastodon.social/@Mastodon",
"https://social.circl.lu/@circl",
"https://fosstodon.org/@username"
],
"maxItems": 100
}

```

---

### 📊 Extracted Post Data (Structured Output)

| Field                | Description                 |
| -------------------- | --------------------------- |
| postId               | Unique post identifier      |
| createdAt            | Post creation date          |
| authorUsername       | Account username            |
| authorDisplayName    | Display name                |
| authorUrl            | Profile URL                 |
| authorFollowersCount | Followers count             |
| authorStatusesCount  | Total posts count           |
| contentText          | Post content                |
| visibility           | Public / Unlisted / Private |
| language             | Detected language           |
| repliesCount         | Number of replies           |
| reblogsCount         | Number of boosts            |
| favouritesCount      | Number of favourites        |
| tags                 | Hashtags                    |
| mediaAttachments     | Images / Videos / GIFs      |
| sensitive            | Sensitive content flag      |
| inReplyToId          | Parent post ID              |
| postUrl              | Direct post URL             |
| sourceUrl            | Source profile URL          |

---

### 💡 Use Cases (High Demand SEO Keywords)

This Mastodon scraper is used for:

📢 Mastodon scraping

📊 Social media monitoring

🕵️ OSINT investigations

📈 Trend analysis

🏷️ Hashtag monitoring

🏢 Brand reputation tracking

🤖 AI training datasets

📡 Audience intelligence

📊 Engagement analytics

🌍 Decentralized social network research

⚡ Bulk Mastodon data extraction

---

### 🚀 Key Features (Apify SEO Optimized)

⚡ Bulk URL scraping support

🌍 Multi-instance Mastodon support

📌 Smart pagination system

🧠 Structured dataset output

📊 Rich engagement metrics

🔁 Auto retry & stability system

🖼️ Media extraction support

💾 Export-ready datasets

⚙️ Scalable cloud execution

---

### 📤 Output Formats Supported

✔ JSON (API Ready)

✔ CSV (Excel Compatible)

✔ Excel XLSX

✔ XML

✔ HTML

---

### 📦 Example Output

```

{
"postId": "111111111111111111",
"createdAt": "2026-04-14T10:00:00Z",
"authorUsername": "circl",
"authorDisplayName": "CIRCL",
"authorUrl": "https://social.circl.lu/@circl",
"authorFollowersCount": 12000,
"authorStatusesCount": 5400,
"contentText": "New vulnerability report published 🚨",
"visibility": "public",
"language": "en",
"repliesCount": 12,
"reblogsCount": 45,
"favouritesCount": 180,
"tags": \["cybersecurity","vulnerability"],
"mediaAttachments": \[
"https://example.com/image.jpg"
],
"sensitive": false,
"inReplyToId": null,
"postUrl": "https://social.circl.lu/@circl/111111111111111111",
"sourceUrl": "https://social.circl.lu/@circl"
}

````

---

### 🔥 Why This is the BEST Mastodon Scraper on Apify?

✔ Optimized for Apify search ranking

✔ Supports bulk profile URL scraping

✔ Works across public Mastodon instances

✔ Rich engagement & metadata extraction

✔ Fast extraction engine

✔ Enterprise-ready scalability

✔ Perfect for OSINT workflows

✔ Excellent SEO visibility

---

### 💸 Pricing

This scraper runs on a pay-per-result pricing model.

You only pay for successfully extracted records.

💳 Price: $0.99 / 1,000 results

---

### ❓ FAQ (SEO BOOST SECTION)

#### Can I scrape multiple Mastodon profiles at once?

Yes — bulk URL mode is fully supported.

#### Does it work with all Mastodon instances?

Yes — any public Mastodon instance is supported.

#### Can I collect hashtags and engagement metrics?

Yes — favourites, boosts, replies, hashtags and media are extracted.

#### Is coding required?

No — 100% no-code Apify Actor.

#### Can I export the data?

Yes — JSON, CSV, Excel, XML and HTML formats are supported.

---

### ⚠️ Disclaimer

This tool is not affiliated with Mastodon. It is an independent data extraction solution.

---

### 🔗 Related Actors (Social Media Intelligence Suite)

We are building a complete **PrimeScrape Social Intelligence Ecosystem**:

👉 Coming Soon 🚀

---

### 🌍 PrimeScrape Ecosystem

Built for **data scraping, OSINT, AI training datasets, audience intelligence and market research at scale**.

📢 Social media scraping

🕵️ OSINT investigations

📊 Audience analytics

🏷️ Trend monitoring

🤖 AI datasets

📈 Market intelligence

⚙️ Automation pipelines

---

### 📬 Support

⭐⭐⭐⭐⭐ Leave a review if you like this scraper

📩 Contact us for custom scraping solutions, enterprise integrations and large-scale data extraction projects.

# Actor input Schema

## `urls` (type: `array`):

List of Mastodon profile URLs to scrape posts from. 

Examples:
• https://mastodon.social/@Mastodon
• https://social.circl.lu/@circl
• https://social.circl.lu/@NoName57Bot

⚠️ Any public Mastodon instance is supported.
## `maxItems` (type: `integer`):

Maximum number of posts to collect per profile URL. 

## Actor input object example

```json
{
  "urls": [
    "https://mastodon.social/@Mastodon",
    "https://social.circl.lu/@circl",
    "https://social.circl.lu/@NoName57Bot"
  ],
  "maxItems": 40
}
````

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://mastodon.social/@Mastodon",
        "https://social.circl.lu/@circl",
        "https://social.circl.lu/@NoName57Bot"
    ],
    "maxItems": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("delectable_incubator/mastodon-posts-scraper-low-cost").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "https://mastodon.social/@Mastodon",
        "https://social.circl.lu/@circl",
        "https://social.circl.lu/@NoName57Bot",
    ],
    "maxItems": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("delectable_incubator/mastodon-posts-scraper-low-cost").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://mastodon.social/@Mastodon",
    "https://social.circl.lu/@circl",
    "https://social.circl.lu/@NoName57Bot"
  ],
  "maxItems": 40
}' |
apify call delectable_incubator/mastodon-posts-scraper-low-cost --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=delectable_incubator/mastodon-posts-scraper-low-cost",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Mastodon Posts Scraper - Low-cost💲🔥📢🐘",
        "description": "🔎 Extract Mastodon posts and profile insights with ease. Collect author details, post content, hashtags, engagement metrics, media attachments, external links, publication dates, and post URLs. Ideal for OSINT research, trend analysis and decentralized social media monitoring 📊🚀",
        "version": "0.0",
        "x-build-id": "rd5N5Oc8FLNnN8co9"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/delectable_incubator~mastodon-posts-scraper-low-cost/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-delectable_incubator-mastodon-posts-scraper-low-cost",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/delectable_incubator~mastodon-posts-scraper-low-cost/runs": {
            "post": {
                "operationId": "runs-sync-delectable_incubator-mastodon-posts-scraper-low-cost",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/delectable_incubator~mastodon-posts-scraper-low-cost/run-sync": {
            "post": {
                "operationId": "run-sync-delectable_incubator-mastodon-posts-scraper-low-cost",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "urls",
                    "maxItems"
                ],
                "properties": {
                    "urls": {
                        "title": "Mastodon Profile URLs 🐘",
                        "type": "array",
                        "description": "List of Mastodon profile URLs to scrape posts from. \n\nExamples:\n• https://mastodon.social/@Mastodon\n• https://social.circl.lu/@circl\n• https://social.circl.lu/@NoName57Bot\n\n⚠️ Any public Mastodon instance is supported.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Maximum Posts per URL 📄",
                        "type": "integer",
                        "description": "Maximum number of posts to collect per profile URL. ",
                        "default": 40
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
