Pinterest BulkPublish

Pinterest API

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

Pinterest APIでできること

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

機能	エンドポイント
投稿の作成、予約、更新、公開	`POST /api/posts`
画像と動画のアップロード	`POST /api/media`
キューの次の空き枠を探す	`GET /api/posts/queue-slot`
繰り返しスケジュールの作成	`POST /api/schedules`
RSSフィードの新着を公開	`POST /api/rss-feeds`
チャンネルのPinterestボードを取得	`GET /api/channels/{id}/options`
投稿ごとの指標を取得	`GET /api/posts/{id}/metrics`
接続が正常か確認	`GET /api/channels/{id}/health`
プランの使用状況を確認	`GET /api/quotas/usage`

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

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

投稿の種類	メディア
`pin` Pin	必須：1点の画像
`video_pin` Video Pin	必須：1本の動画
`carousel` Carousel	必須：2〜5点の画像

curlでPinterestの投稿を予約する

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

1. チャンネルの一覧を取得し、Pinterestアカウントの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 20 minute pasta for busy evenings",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "pinterest": {
      "12": {
        "boardId": "BOARD_ID"
      },
      "title": "Weeknight pasta",
      "link": "https://example.com/pasta"
    }
  }
}'

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

Pinterestのオプション

platformSpecificの中の、Pinterest用のキーの下に指定します。

Pinterestのオプションは、たとえば"12"のようにチャンネルIDをキーにして指定します。キーなしで指定すると、投稿内のすべてのPinterestチャンネルに適用されます。

オプション	内容	指定できる値
`title`	タイトル	テキスト
`description`	説明	テキスト
`link`	遷移先リンク	テキスト
`dominantColor`	ピンの背景色	テキスト
`coverImageUrl`	動画ピンのカバー画像	テキスト
`boardId`	ピンの保存先ボード	テキスト