Mastodon BulkPublish

API Mastodon

Publiez, programmez et gérez Mastodon depuis votre propre code. Une seule API REST et une seule clé couvrent Mastodon et tous les autres réseaux que vous connectez : vous écrivez l’intégration une seule fois.

Obtenir une clé d’API gratuite Lire la référence de l’API

Ce que couvre l’API Mastodon

Tout ce qui suit fait partie de l’API publiée et fonctionne dès aujourd’hui avec Mastodon.

Fonction	Endpoint
Créer, programmer, modifier et publier des publications	`POST /api/posts`
Importer des images et des vidéos	`POST /api/media`
Trouver le prochain créneau libre de votre file	`GET /api/posts/queue-slot`
Créer des programmations récurrentes	`POST /api/schedules`
Publier les nouveaux éléments d’un flux RSS	`POST /api/rss-feeds`
Publier automatiquement un premier commentaire	`platformSpecific._firstComment`
Publier des fils en plusieurs parties	`postFormat: "thread"`
Lire les statistiques de chaque publication	`GET /api/posts/{id}/metrics`
Lire les commentaires des publications et y répondre	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Lire et répondre aux messages privés	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Vérifier que la connexion fonctionne bien	`GET /api/channels/{id}/health`
Consulter l’utilisation de votre offre	`GET /api/quotas/usage`

Types de publication pour Mastodon

Choisissez le type avec postTypeOverrides. Un type que Mastodon ne propose pas est refusé avant toute mise en file.

Type de publication	Médias
`post` Post	Facultatif, jusqu’à 4 images ou vidéos

Programmer une publication Mastodon avec curl

Trois requêtes : trouver votre canal, importer le fichier si la publication en a un, puis créer la publication. Remplacez la clé par une clé de Paramètres, puis Clés d’API, et 12 par l’identifiant de votre propre canal.

1. Listez vos canaux et notez l’identifiant de votre compte Mastodon.

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

2. Créez la publication.

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

La réponse est la publication créée, avec son identifiant et son statut. Récupérez-la plus tard avec GET /api/posts/{id} pour voir comment cela s’est passé.

Options Mastodon

Mastodon n’accepte aucune option supplémentaire. Le texte, les médias et le type de publication suffisent à une requête.

Statistiques Mastodon via l’API

Ces métriques sont renvoyées pour chaque publication Mastodon sur GET /api/posts/{id}/metrics, avec des instantanés au fil du temps.

J’aime
Commentaires
Partages

Commentaires et messages

Via l’API, vous pouvez lire les commentaires des publications et y répondre et lire les messages privés et y répondre.

La lecture des commentaires fonctionne sur toutes les offres. Y répondre demande une offre payante, et la boîte de réception fait partie de Pro et Business. Tant qu’une fonction n’est pas activée sur votre compte, l’API répond 403 avec un code que vous pouvez tester.

Accès API sur toutes les offres

Chaque offre inclut des clés d’API, l’offre Free comprise. Voici ce que permet chacune.

Offre	Clés d’API	Requêtes par jour
Free	1	30
Pro	5	5 000
Business	10	50 000

Construire directement sur Mastodon, ou passer par BulkPublish

Passer en direct est un choix raisonnable, surtout si vous avez besoin de quelque chose que BulkPublish n’expose pas. Voici ce que Mastodon API exige de vous, vérifié dans sa documentation en octobre 2026.

Vous devez enregistrer une application développeur auprès de Mastodon avant de pouvoir publier.
L’API peut programmer une publication elle-même, dans les limites fixées par la plateforme.
Une publication avec média demande plusieurs appels : importer ou créer, attendre le traitement, puis publier.

BulkPublish garde la connexion pour vous : il renouvelle les jetons, vérifie chaque publication selon les règles de Mastodon avant la mise en file et signale sur la publication une destination en échec, si bien que votre code n’envoie qu’une requête.

Lire la documentation officielle

Vous préférez demander à un assistant ?

Claude, ChatGPT et Cursor peuvent faire la même chose via le serveur MCP Mastodon, avec des demandes au lieu de code.

Voir le serveur MCP Mastodon

Vous préférez un calendrier au code ?

Le même compte Mastodon peut être programmé depuis l’app, avec un calendrier de contenu et l’import en masse.

Voir le planificateur Mastodon

Questions fréquentes

Questions courantes sur l’API Mastodon.

Existe-t-il une API Mastodon utilisable sans construire l’intégration moi-même ?

Oui. BulkPublish expose Mastodon via son API REST. Connectez votre compte Mastodon une fois, puis publiez, programmez et gérez-le avec une clé. La même clé fonctionne pour tous les autres réseaux que vous connectez.

Que puis-je publier sur Mastodon via l’API ?

Les types de publication sont Post. Chacun est vérifié selon les règles média de Mastodon avant toute mise en file : une requête que Mastodon refuserait échoue donc immédiatement, avec une erreur claire.

Puis-je programmer des publications Mastodon via l’API ?

Oui. Envoyez le statut "scheduled" avec une heure scheduledAt et un timezone, ou demandez d’abord le prochain créneau libre de votre file. Les programmations récurrentes et les flux RSS sont aussi disponibles.

Puis-je lire les statistiques Mastodon via l’API ?

Oui. Les métriques par publication incluent J’aime, Commentaires et Partages, avec des instantanés au fil du temps.

Puis-je lire les commentaires ou messages Mastodon et y répondre via l’API ?

Oui. Vous pouvez lire les commentaires des publications et y répondre et lire les messages privés et y répondre. Répondre aux commentaires demande une offre payante, et la boîte de réception fait partie de Pro et Business.

L’API Mastodon coûte-t-elle un supplément ?

Non. L’accès API est inclus dans toutes les offres. Free comprend 1 clé et 30 requêtes par jour, Pro 5 clés et 5 000 par jour, Business 10 clés et 50 000 par jour.

Me faut-il un compte développeur Mastodon ou une validation d’application ?

Pas pour utiliser BulkPublish. Vous connectez votre compte Mastodon sur la page Canaux et publiez avec une clé BulkPublish. Si vous construisez plutôt sur l’API propre de Mastodon, la section ci-dessus liste ce qu’elle exige de vous.

Un assistant IA peut-il le faire aussi ?

Oui. La page du serveur MCP Mastodon explique comment connecter Claude, ChatGPT ou Cursor et quoi demander.

La même clé et la même forme de requête fonctionnent pour 15 réseaux.