Mastodon BulkPublish

Mastodon API

Publiceer, plan en beheer Mastodon vanuit je eigen code. Eén REST API en één sleutel dekken Mastodon en elk ander netwerk dat je koppelt, dus je schrijft de integratie maar één keer.

Vraag een gratis API-sleutel aan Lees de API-referentie

Wat de Mastodon API kan

Alles hieronder maakt deel uit van de gepubliceerde API en werkt vandaag met Mastodon.

Mogelijkheid	Endpoint
Posts aanmaken, inplannen, bijwerken en publiceren	`POST /api/posts`
Afbeeldingen en video uploaden	`POST /api/media`
De eerstvolgende vrije plek in je wachtrij vinden	`GET /api/posts/queue-slot`
Terugkerende planningen aanmaken	`POST /api/schedules`
Nieuwe items uit een RSS-feed publiceren	`POST /api/rss-feeds`
Automatisch een eerste reactie plaatsen	`platformSpecific._firstComment`
Threads met meerdere delen publiceren	`postFormat: "thread"`
Statistieken per post uitlezen	`GET /api/posts/{id}/metrics`
Reacties op gepubliceerde posts lezen en beantwoorden	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Directe berichten lezen en beantwoorden	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Controleren of de koppeling gezond is	`GET /api/channels/{id}/health`
Het verbruik van je abonnement controleren	`GET /api/quotas/usage`

Posttypen die je op Mastodon kunt publiceren

Kies het type met postTypeOverrides. Een type dat Mastodon niet biedt, wordt geweigerd voordat er iets in de wachtrij komt.

Berichttype	Media
`post` Post	Optioneel, maximaal 4 afbeeldingen of video's

Een Mastodon-post inplannen met curl

Drie verzoeken: zoek je kanaal, upload het bestand als de post er een heeft en maak dan de post aan. Vervang de sleutel door een sleutel uit Instellingen, dan API-sleutels, en 12 door je eigen kanaal-id.

1. Lijst je kanalen op en noteer de id van je Mastodon-account.

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

2. Maak de post aan.

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"
  }
}'

Het antwoord is de aangemaakte post, met id en status. Haal hem later op met GET /api/posts/{id} om te zien hoe het ging.

Mastodon-opties

Mastodon heeft geen extra opties. Tekst, media en posttype zijn alles wat een verzoek nodig heeft.

Mastodon-analytics via de API

Deze statistieken komen terug voor elke Mastodon-post op GET /api/posts/{id}/metrics, met momentopnames in de tijd.

Likes
Reacties
Gedeeld

Reacties en berichten

Via de API kun je reacties op gepubliceerde posts lezen en beantwoorden en directe berichten lezen en beantwoorden.

Reacties lezen kan in elk abonnement. Reacties beantwoorden vraagt om een betaald abonnement, en de inbox zit in Pro en Business. Zolang een functie niet voor je account is ingeschakeld, antwoordt de API met 403 en een code waarop je kunt controleren.

API-toegang in elk abonnement

Elk abonnement bevat API-sleutels, ook het Free-abonnement. Dit is wat elk abonnement toestaat.

Abonnement	API-sleutels	Verzoeken per dag
Free	1	30
Pro	5	5.000
Business	10	50.000

Bouw direct op Mastodon, of gebruik BulkPublish

Direct bouwen is een redelijke keuze, zeker als je iets nodig hebt wat BulkPublish niet biedt. Dit vraagt Mastodon API van je, gecontroleerd aan de hand van de documentatie van oktober 2026.

Je registreert een developer-app bij Mastodon voordat je kunt publiceren.
De API kan een post zelf inplannen, binnen de grenzen die het platform stelt.
Een post met media vraagt om meerdere aanroepen: uploaden of aanmaken, wachten op verwerking en dan publiceren.

BulkPublish houdt de koppeling voor je in stand: het vernieuwt tokens, controleert elke post op de regels van Mastodon voordat hij in de wachtrij komt en meldt een mislukte bestemming bij de post, zodat je code één verzoek doet.

Lees de officiële documentatie

Liever een assistent vragen?

Claude, ChatGPT en Cursor kunnen hetzelfde doen via de Mastodon MCP-server, met opdrachten in plaats van code.

Bekijk de Mastodon MCP-server

Liever een kalender dan code?

Hetzelfde Mastodon-account kun je ook vanuit de app inplannen, met een contentkalender en bulkupload.

Bekijk de Mastodon-planner

Veelgestelde vragen

Veelgestelde vragen over de Mastodon API.

Is er een Mastodon API die ik kan gebruiken zonder de integratie zelf te bouwen?

Ja. BulkPublish biedt Mastodon aan via zijn REST API. Koppel je Mastodon-account één keer en publiceer, plan en beheer het daarna met een sleutel. Dezelfde sleutel werkt voor elk ander netwerk dat je koppelt.

Wat kan ik via de API op Mastodon publiceren?

De posttypen zijn Post. Elk type wordt gecontroleerd op de mediaregels van Mastodon voordat er iets in de wachtrij komt, dus een verzoek dat Mastodon zou weigeren, mislukt meteen met een duidelijke fout.

Kan ik Mastodon-posts via de API inplannen?

Ja. Stuur status "scheduled" met een scheduledAt-tijd en een timezone, of vraag eerst om de eerstvolgende vrije plek in je wachtrij. Terugkerende planningen en RSS-feeds zijn ook beschikbaar.

Kan ik Mastodon-analytics via de API uitlezen?

Ja. De statistieken per post omvatten Likes, Reacties en Gedeeld, met momentopnames in de tijd.

Kan ik Mastodon-reacties of -berichten via de API lezen en beantwoorden?

Ja. Je kunt reacties op gepubliceerde posts lezen en beantwoorden en directe berichten lezen en beantwoorden. Reacties beantwoorden vraagt om een betaald abonnement, en de inbox zit in Pro en Business.

Kost de Mastodon API extra?

Nee. API-toegang zit in elk abonnement. Free bevat 1 sleutel en 30 verzoeken per dag, Pro 5 sleutels en 5.000 per dag, Business 10 sleutels en 50.000 per dag.

Heb ik een Mastodon-developeraccount of een app-review nodig?

Niet om BulkPublish te gebruiken. Je koppelt je Mastodon-account op de pagina Kanalen en publiceert met een BulkPublish-sleutel. Als je in plaats daarvan op de eigen API van Mastodon bouwt, staat in het gedeelte hierboven wat die van je vraagt.

Kan een AI-assistent dit ook doen?

Ja. De pagina over de Mastodon MCP-server laat zien hoe je Claude, ChatGPT of Cursor koppelt en wat je kunt vragen.

Dezelfde sleutel en dezelfde opbouw van verzoeken werken voor 15 netwerken.