You can access the Mastodon (Bulk) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

1import { ApifyClient } from 'apify-client';
2
3// Initialize the ApifyClient with your Apify API token
4// Replace the '<YOUR_API_TOKEN>' with your token
5const client = new ApifyClient({
6    token: '<YOUR_API_TOKEN>',
7});
8
9// Prepare Actor input
10const input = {
11    "keywords": [
12        "@georgetakei",
13        "@nytimes"
14    ],
15    "last_ids": [
16        "112242118329542991",
17        "1"
18    ],
19    "proxy": {
20        "useApifyProxy": true
21    }
22};
23
24// Run the Actor and wait for it to finish
25const run = await client.actor("canadesk/mastodon-bulk").call(input);
26
27// Fetch and print Actor results from the run's dataset (if any)
28console.log('Results from dataset');
29console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
30const { items } = await client.dataset(run.defaultDatasetId).listItems();
31items.forEach((item) => {
32    console.dir(item);
33});
34
35// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

Mastodon (Bulk) API in JavaScript

The Apify API client for JavaScript is the official library that allows you to use Mastodon (Bulk) API in JavaScript or TypeScript, providing convenience functions and automatic retries on errors.

Install the apify-client

$npm install apify-client

Other API clients include:

Mastodon (Bulk) API in Python

Mastodon (Bulk) API through CLI

Mastodon (Bulk) OpenAPI definition

Mastodon (Bulk) API

Mastodon

canadesk/mastodon

Collect Trends, Statuses, Hashtags and Timelines from mastodon.social. It's fast and costs little!

Canadesk Support

Mastodon Explorer

jupri/mastodon-scraper

🐘 Scrape Mastodon Social Network websites

cat

Mastodon Profile Scraper

sandaliaapps/mastodon-profile-scraper

Mastodon Profile Scraper lets you extract rich profile data from any public Mastodon account. Collect usernames, bios, follower counts, join dates, profile URLs, avatars, and more—perfect for research, analytics, and social media monitoring.

Sandalia Apps

5.0

Mastodon Email Scraper – Advanced, Cheapest & Reliable 📧⚡📷

contactminerlabs/mastodon-email-scraper---advanced-cheapest-reliable

🔍 Scrape Mastodon Emails Enter your search parameters to collect verified contact emails from public Mastodon profiles, along with profile title, bio snippet, source URL & platform info ✉️📊 Perfect for lead generation, influencer outreach & data enrichment in tools like Google Sheets or CRMs⚡🧩

ContactMinerLabs

5.0

Bluesky & Mastodon Scraper - Decentralized Social Media

barrierefix/alt-network-bundle

Extract and monitor posts from Bluesky (AT Protocol) and Mastodon (Fediverse). The most comprehensive social media scraper for decentralized networks - perfect for social listening, brand monitoring, market research, sentiment analysis, and AI training data collection.

BarriereFix

5.0

Mastodon Federation Intelligence Pro

red.cars/mastodon-federation-intelligence-pro

The #1 Academic Research Platform for studying decentralized social networks across 1000+ Mastodon instances with comprehensive federation analytics, ethical research compliance, and university budget-friendly subscription pricing.