Tumblr BulkPublish

Tumblr API

自分のコードからTumblrの公開、予約、管理ができます。1つのREST APIと1つのキーで、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の投稿を予約する

3つのリクエストで行います。チャンネルを探し、投稿にファイルがあればアップロードし、投稿を作成します。キーは「設定」の「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のオプションは、たとえば"12"のようにチャンネルIDをキーにして指定します。キーなしで指定すると、投稿内のすべてのTumblrチャンネルに適用されます。

オプション	内容	指定できる値
`blogName`	公開先のブログ	テキスト
`title`	タイトル	テキスト
`tags`	タグ	リスト
`link`	遷移先リンク	テキスト
`sourceUrl`	出典リンク	テキスト