Tumblr BulkPublish

Tumblr API

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

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

BulkPublish 的 Tumblr 集成

Tumblr API 涵盖的内容

下面的一切都属于已公开的 API，今天就能用于 Tumblr。

功能	接口
创建、排期、更新和发布帖子	`POST /api/posts`
上传图片和视频	`POST /api/media`
查找队列中的下一个空闲时段	`GET /api/posts/queue-slot`
创建重复排期	`POST /api/schedules`
发布 RSS 源中的新内容	`POST /api/rss-feeds`
查询某个频道的 Tumblr 博客	`GET /api/channels/{id}/options`
读取已发布帖子下的评论	`GET /api/posts/{id}/engagement`
检查连接是否正常	`GET /api/channels/{id}/health`
查看套餐用量	`GET /api/quotas/usage`

可发布到 Tumblr 的帖子类型

用 postTypeOverrides 选择类型。Tumblr 不提供的类型会在排队之前就被拒绝。

内容类型	媒体
`post` Post	可选，最多 30 个图片或视频

用 curl 排期一条 Tumblr 帖子

三个请求：找到你的频道，帖子有文件的话先上传，然后创建帖子。把密钥换成你在设置，再到 API 密钥里生成的那个，把 12 换成你自己的频道 id。

1. 列出你的频道，记下 Tumblr 账号的 id。

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

2. 上传文件。响应会给出媒体 id，下面作为 mediaFiles 使用。

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. 创建帖子。

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "A look at this week in the studio",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "tumblr": {
      "12": {
        "title": "Studio notes",
        "tags": [
          "process",
          "studio"
        ]
      }
    }
  }
}'

响应是创建好的帖子，带有 id 和状态。之后用 GET /api/posts/{id} 获取，查看发布结果。

Tumblr 选项

把这些放在 platformSpecific 里，使用 Tumblr 对应的键。

对 Tumblr 来说，选项按你的频道 id 作为键，例如 "12"，也可以平铺发送，应用到帖子中的每个 Tumblr 频道。

选项	作用	接受的值
`blogName`	发布到哪个博客	文本
`title`	标题	文本
`tags`	标签	列表
`link`	目标链接	文本
`sourceUrl`	来源链接	文本

要查找某个频道可用的博客，请调用 GET /api/channels/{id}/options。

通过 API 获取 Tumblr 数据分析

Tumblr 无法提供每条帖子的数据，因此没有可读取的内容。

评论和消息

通过 API，你可以读取已发布帖子下的评论。

读取评论所有套餐都支持。回复评论需要付费套餐，收件箱属于 Pro 和 Business。在你的账号开通某项功能之前，API 会返回 403 和一个可供检查的代码。

所有套餐都能使用 API

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

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

直接对接 Tumblr，还是使用 BulkPublish

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

阅读官方文档

想直接问助手？

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

查看 Tumblr MCP 服务器

更喜欢日历而不是代码？

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

查看 Tumblr 定时发布工具

常见问题

关于 Tumblr API 的常见问题。

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

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

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

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

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

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

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

读不到每条帖子的数据。Tumblr 不提供这些数据。

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

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

Tumblr API 要额外付费吗？

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

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

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

AI 助手也能做这些吗？

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

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

查看所有网络的 API

开始用代码发布到 Tumblr

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

获取免费 API 密钥查看价格