Mastodon BulkPublish

Mastodon API

Veröffentliche, plane und verwalte Mastodon aus deinem eigenen Code. Eine REST-API und ein Schlüssel decken Mastodon und jedes andere verbundene Netzwerk ab, du schreibst die Integration also nur einmal.

Kostenlosen API-Schlüssel holen API-Referenz lesen

Was die Mastodon API abdeckt

Alles unten gehört zur veröffentlichten API und funktioniert heute mit Mastodon.

Funktion	Endpunkt
Beiträge erstellen, planen, bearbeiten und veröffentlichen	`POST /api/posts`
Bilder und Videos hochladen	`POST /api/media`
Den nächsten freien Slot in deiner Warteschlange finden	`GET /api/posts/queue-slot`
Wiederkehrende Pläne anlegen	`POST /api/schedules`
Neue Einträge aus einem RSS-Feed veröffentlichen	`POST /api/rss-feeds`
Automatisch einen ersten Kommentar posten	`platformSpecific._firstComment`
Mehrteilige Threads veröffentlichen	`postFormat: "thread"`
Kennzahlen pro Beitrag lesen	`GET /api/posts/{id}/metrics`
Kommentare unter veröffentlichten Beiträgen lesen und beantworten	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Direktnachrichten lesen und beantworten	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Prüfen, ob die Verbindung in Ordnung ist	`GET /api/channels/{id}/health`
Die Nutzung deines Tarifs prüfen	`GET /api/quotas/usage`

Beitragstypen, die du auf Mastodon veröffentlichen kannst

Wähle den Typ mit postTypeOverrides. Ein Typ, den Mastodon nicht anbietet, wird abgelehnt, bevor etwas eingereiht wird.

Beitragstyp	Medien
`post` Post	Optional, bis zu 4 Bilder oder Videos

Einen Mastodon-Beitrag mit curl planen

Drei Anfragen: Kanal finden, die Datei hochladen, falls der Beitrag eine hat, dann den Beitrag erstellen. Ersetze den Schlüssel durch einen aus Einstellungen, dann API-Schlüssel, und 12 durch deine eigene Kanal-ID.

1. Liste deine Kanäle auf und notiere die ID deines Mastodon-Kontos.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Erstelle den Beitrag.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "New post is up",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "platformSpecific": {
    "_firstComment": "Full write-up on the blog"
  }
}'

Die Antwort ist der erstellte Beitrag mit ID und Status. Rufe ihn später mit GET /api/posts/{id} ab, um zu sehen, wie es lief.

Mastodon-Optionen

Mastodon nimmt keine zusätzlichen Optionen entgegen. Text, Medien und Beitragstyp reichen für eine Anfrage aus.

Mastodon-Analysen über die API

Diese Kennzahlen kommen für jeden Mastodon-Beitrag über GET /api/posts/{id}/metrics zurück, mit Momentaufnahmen im Zeitverlauf.

Likes
Kommentare
Geteilt

Kommentare und Nachrichten

Über die API kannst du Kommentare unter veröffentlichten Beiträgen lesen und beantworten und Direktnachrichten lesen und beantworten.

Kommentare lesen geht in jedem Tarif. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business. Solange eine Funktion für dein Konto nicht freigeschaltet ist, antwortet die API mit 403 und einem Code, den du abfragen kannst.

API-Zugriff in jedem Tarif

Jeder Tarif enthält API-Schlüssel, auch der Free-Tarif. Das erlaubt jeder Stufe.

Tarif	API-Schlüssel	Anfragen pro Tag
Free	1	30
Pro	5	5.000
Business	10	50.000

Direkt auf Mastodon aufbauen oder BulkPublish nutzen

Der direkte Weg ist eine faire Wahl, besonders wenn du etwas brauchst, das BulkPublish nicht anbietet. Das verlangt Mastodon API von dir, geprüft anhand der Dokumentation im Oktober 2026.

Du registrierst eine Entwickler-App bei Mastodon, bevor du veröffentlichen kannst.
Die API kann einen Beitrag selbst planen, innerhalb der Grenzen, die die Plattform setzt.
Ein Beitrag mit Medien braucht mehrere Aufrufe: hochladen oder anlegen, auf die Verarbeitung warten, dann veröffentlichen.

BulkPublish hält die Verbindung für dich aufrecht: Es erneuert Tokens, prüft jeden Beitrag vor dem Einreihen gegen die Regeln von Mastodon und meldet ein fehlgeschlagenes Ziel am Beitrag, sodass dein Code nur eine Anfrage stellt.

Offizielle Dokumentation lesen

Lieber einen Assistenten fragen?

Claude, ChatGPT und Cursor können dasselbe über den Mastodon-MCP-Server, mit Prompts statt Code.

Den Mastodon-MCP-Server ansehen

Lieber einen Kalender als Code?

Dasselbe Mastodon-Konto lässt sich auch in der App planen, mit Content-Kalender und Massen-Upload.

Den Mastodon-Planer ansehen

Häufige Fragen

Häufige Fragen zur Mastodon API.

Gibt es eine Mastodon API, die ich nutzen kann, ohne die Integration selbst zu bauen?

Ja. BulkPublish stellt Mastodon über seine REST-API bereit. Verbinde dein Mastodon-Konto einmal, dann kannst du es mit einem Schlüssel veröffentlichen, planen und verwalten. Derselbe Schlüssel funktioniert für jedes andere verbundene Netzwerk.

Was kann ich über die API auf Mastodon veröffentlichen?

Die Beitragstypen sind Post. Jeder wird vor dem Einreihen gegen die Medienregeln von Mastodon geprüft, eine Anfrage, die Mastodon ablehnen würde, scheitert also sofort mit einer klaren Fehlermeldung.

Kann ich Mastodon-Beiträge über die API planen?

Ja. Sende den Status "scheduled" mit einer scheduledAt-Zeit und einer timezone, oder frage zuerst nach dem nächsten freien Slot in deiner Warteschlange. Wiederkehrende Pläne und RSS-Feeds gibt es ebenfalls.

Kann ich Mastodon-Analysen über die API lesen?

Ja. Zu den Kennzahlen pro Beitrag gehören Likes, Kommentare und Geteilt, mit Momentaufnahmen im Zeitverlauf.

Kann ich Mastodon-Kommentare oder -Nachrichten über die API lesen und beantworten?

Ja. Du kannst Kommentare unter veröffentlichten Beiträgen lesen und beantworten und Direktnachrichten lesen und beantworten. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business.

Kostet die Mastodon API extra?

Nein. Der API-Zugriff ist in jedem Tarif enthalten. Free umfasst 1 Schlüssel und 30 Anfragen am Tag, Pro 5 Schlüssel und 5.000 am Tag, Business 10 Schlüssel und 50.000 am Tag.

Brauche ich ein Mastodon-Entwicklerkonto oder eine App-Prüfung?

Nicht, um BulkPublish zu nutzen. Du verbindest dein Mastodon-Konto auf der Seite Kanäle und veröffentlichst mit einem BulkPublish-Schlüssel. Wenn du stattdessen auf der eigenen API von Mastodon aufbaust, steht im Abschnitt oben, was sie von dir verlangt.

Kann das auch ein KI-Assistent erledigen?

Ja. Die Seite zum Mastodon-MCP-Server zeigt, wie du Claude, ChatGPT oder Cursor verbindest und was du anfragen kannst.

Derselbe Schlüssel und dieselbe Anfrageform funktionieren für 15 Netzwerke.