Mastodon BulkPublish

Mastodon API

自分のコードからMastodonの公開、予約、管理ができます。1つのREST APIと1つのキーで、Mastodonと接続済みのほかのネットワークをまとめて扱えるので、連携の実装は一度で済みます。

Mastodon APIでできること

以下はすべて公開されているAPIの機能で、Mastodonで今すぐ使えます。

機能	エンドポイント
投稿の作成、予約、更新、公開	`POST /api/posts`
画像と動画のアップロード	`POST /api/media`
キューの次の空き枠を探す	`GET /api/posts/queue-slot`
繰り返しスケジュールの作成	`POST /api/schedules`
RSSフィードの新着を公開	`POST /api/rss-feeds`
最初のコメントを自動で投稿	`platformSpecific._firstComment`
複数パートのスレッドを公開	`postFormat: "thread"`
投稿ごとの指標を取得	`GET /api/posts/{id}/metrics`
公開済み投稿のコメントを読んで返信	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
ダイレクトメッセージの閲覧と返信	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
接続が正常か確認	`GET /api/channels/{id}/health`
プランの使用状況を確認	`GET /api/quotas/usage`

Mastodonに公開できる投稿タイプ

タイプはpostTypeOverridesで指定します。Mastodonが対応していないタイプは、キューに入る前に拒否されます。

投稿の種類	メディア
`post` Post	任意、最大4点の画像または動画

curlでMastodonの投稿を予約する

3つのリクエストで行います。チャンネルを探し、投稿にファイルがあればアップロードし、投稿を作成します。キーは「設定」の「APIキー」で取得したものに、12は自分のチャンネルIDに置き換えてください。

1. チャンネルの一覧を取得し、MastodonアカウントのIDを控えます。

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

2. 投稿を作成します。

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

レスポンスは作成された投稿で、IDとステータスが含まれます。あとからGET /api/posts/{id}で取得すると、結果を確認できます。

Mastodonのオプション

Mastodonに追加のオプションはありません。リクエストに必要なのは、テキスト、メディア、投稿タイプだけです。

APIで取得するMastodonの分析

Mastodonの各投稿について、次の指標をGET /api/posts/{id}/metricsで取得できます。時間ごとのスナップショットも含まれます。

コメントとメッセージ

APIから公開済み投稿のコメントを読んで返信する、ダイレクトメッセージを読んで返信することができます。

コメントの閲覧は全プランで使えます。コメントへの返信は有料プランが必要で、受信箱はProとBusinessに含まれます。機能がアカウントで有効になるまでは、APIが403と確認用のコードを返します。

全プランでAPIを利用可能

Freeを含むすべてのプランにAPIキーが付いています。各プランの内容は次のとおりです。

プラン	APIキー	1日のリクエスト数
Free	1	30
Pro	5	5,000
Business	10	50,000

Mastodonに直接つなぐか、BulkPublishを使うか

直接つなぐのも妥当な選択です。BulkPublishにない機能が必要なときは特にそうです。Mastodon APIを使う場合に求められる作業を、2026年10月時点のドキュメントで確認してまとめました。

公開するには、事前にMastodonへデベロッパーアプリを登録する必要があります。
このAPIには予約機能があり、投稿の予約ができます。ただしプラットフォームが定める範囲内です。
メディア付きの投稿は複数回の呼び出しが必要です。アップロードまたは作成、処理の完了待ち、公開の順に進みます。

BulkPublishが接続を維持します。トークンの更新、キューに入れる前のMastodonのルールの確認、失敗した投稿先の報告まで行うので、コードで送るリクエストは1回で済みます。

公式ドキュメントを読む

アシスタントに頼みたい方へ

Claude、ChatGPT、Cursorでも、Mastodon MCPサーバーを通じて同じことができます。コードではなくプロンプトで操作します。

Mastodon MCPサーバーを見る

コードよりカレンダーが好みなら

同じMastodonアカウントを、アプリのコンテンツカレンダーと一括アップロードで予約できます。

Mastodonスケジューラーを見る

よくある質問

Mastodon APIについてよくある質問です。

連携を自分で作らずに使えるMastodon APIはありますか？

はい。BulkPublishはMastodonをREST APIで提供しています。Mastodonアカウントを一度接続すれば、キーで公開、予約、管理ができます。同じキーで、接続済みのほかのネットワークも扱えます。

APIからMastodonに何を公開できますか？

投稿タイプはPostです。どれもキューに入る前にMastodonのメディアルールで確認されるため、Mastodonが拒否するリクエストは、すぐに分かりやすいエラーで失敗します。

APIでMastodonの投稿を予約できますか？

はい。status "scheduled"にscheduledAtの時刻とtimezoneを添えて送るか、先にキューの次の空き枠を取得します。繰り返しスケジュールとRSSフィードも使えます。

APIでMastodonの分析を取得できますか？

はい。投稿ごとの指標にはいいね、コメント、シェアが含まれ、時間ごとのスナップショットも取得できます。

APIでMastodonのコメントやメッセージを読んで返信できますか？

はい。公開済み投稿のコメントを読んで返信する、ダイレクトメッセージを読んで返信することができます。コメントへの返信は有料プランが必要で、受信箱はProとBusinessに含まれます。

Mastodon APIは追加料金がかかりますか？

いいえ。APIは全プランで使えます。Freeはキー1個と1日30リクエスト、Proはキー5個と1日5,000リクエスト、Businessはキー10個と1日50,000リクエストです。

Mastodonのデベロッパーアカウントやアプリの審査は必要ですか？

BulkPublishを使う場合は不要です。「チャンネル」ページでMastodonアカウントを接続し、BulkPublishのキーで公開します。Mastodonの公式APIで自作する場合に求められる内容は、上のセクションにまとめています。

AIアシスタントでも同じことができますか？

はい。Mastodon MCPサーバーのページで、Claude、ChatGPT、Cursorの接続方法と、頼める内容を紹介しています。

同じキーと同じリクエスト形式で、15のネットワークを扱えます。

すべてのネットワークAPIを見る

コードからMastodonへの投稿を始めましょう

無料アカウントを作成し、Mastodonを接続してキーを発行します。カードは不要です。

無料のAPIキーを取得料金を見る