Mastodon BulkPublish

Mastodon API

用你自己的代码发布、排期和管理 Mastodon。一个 REST API 和一个密钥就能覆盖 Mastodon 和你连接的其他所有网络，集成只需写一次。

获取免费 API 密钥阅读 API 参考

BulkPublish 的 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 帖子

三个请求：找到你的频道，帖子有文件的话先上传，然后创建帖子。把密钥换成你在设置，再到 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

每个套餐都包含 API 密钥，Free 套餐也不例外。各套餐的额度如下。

套餐	API 密钥	每日请求数
Free	1	30
Pro	5	5,000
Business	10	50,000

直接对接 Mastodon，还是使用 BulkPublish

直接对接是个合理的选择，尤其是你需要 BulkPublish 没有开放的功能时。以下是 Mastodon API 对你的要求，已于 2026年10月对照其文档核实。

发布之前，你需要先在 Mastodon 注册一个开发者应用。
API 本身可以排期帖子，但受平台设定的限制约束。
带素材的帖子需要多次调用：上传或创建，等待处理，然后发布。

BulkPublish 替你维护连接：刷新令牌，在排队之前按 Mastodon 的规则检查每条帖子，并在帖子上报告失败的目标，所以你的代码只需发一个请求。

阅读官方文档

想直接问助手？

Claude、ChatGPT 和 Cursor 可以通过 Mastodon MCP 服务器完成同样的事，用提示词代替代码。

查看 Mastodon MCP 服务器

更喜欢日历而不是代码？

同一个 Mastodon 账号也可以在应用里排期，配有内容日历和批量上传。

查看 Mastodon 定时发布工具

常见问题

关于 Mastodon API 的常见问题。

有没有不用自己开发集成就能用的 Mastodon API？

有。BulkPublish 通过它的 REST API 开放 Mastodon。只需连接一次 Mastodon 账号，之后就可以用密钥发布、排期和管理。同一个密钥也适用于你连接的其他所有网络。

通过 API 可以向 Mastodon 发布什么？

帖子类型有 Post。排队之前，每条内容都会按 Mastodon 的素材规则检查，所以 Mastodon 会拒绝的请求会立刻失败，并给出清楚的错误。

可以通过 API 排期 Mastodon 帖子吗？

可以。发送状态 "scheduled"，并带上 scheduledAt 时间和 timezone，或者先请求队列中的下一个空闲时段。重复排期和 RSS 源同样可用。

可以通过 API 读取 Mastodon 数据分析吗？

可以。每条帖子的数据包括点赞、评论和转发，并带有随时间变化的快照。

可以通过 API 读取并回复 Mastodon 的评论或消息吗？

可以。你可以读取并回复已发布帖子下的评论和读取并回复私信。回复评论需要付费套餐，收件箱属于 Pro 和 Business。

Mastodon API 要额外付费吗？

不用。所有套餐都能使用 API。Free 包含 1 个密钥和每天 30 次请求，Pro 为 5 个密钥和每天 5,000 次，Business 为 10 个密钥和每天 50,000 次。

需要 Mastodon 开发者账号或应用审核吗？

使用 BulkPublish 不需要。你在频道页面连接 Mastodon 账号，用 BulkPublish 密钥发布即可。如果你改为直接对接 Mastodon 自己的 API，上面的部分列出了它对你的要求。

AI 助手也能做这些吗？

能。Mastodon MCP 服务器页面介绍了如何连接 Claude、ChatGPT 或 Cursor，以及该怎么提问。

同一个密钥和同样的请求格式适用于 15 个网络。

查看所有网络的 API

开始用代码发布到 Mastodon

创建免费账号，连接 Mastodon，生成密钥。无需绑定银行卡。

获取免费 API 密钥查看价格