API（開発者向け・v1）

公開REST API /v1。APIキー認証・投稿/生成・データ取得・Webhook・課金/レート制限。

API（開発者向け・v1）

posti の公開 REST API を使うと、外部システムから投稿の作成・AI生成・データの取得を自動化できます。認証は API キー（Bearer トークン）です。

認証

1. サイドバーの 設定 → APIキー を開く。
2. API キーを発行する（posti_ で始まる文字列。発行時のみ全体が表示されるので安全に保管してください）。
3. すべてのリクエストに Authorization: Bearer <APIキー> ヘッダを付ける。

curl -H "Authorization: Bearer posti_xxxxxxxx" https://posti.jp/v1/accounts

キーが無い・無効な場合は 401 が返ります。

ベースURL

https://posti.jp/v1

すべてのレスポンスは JSON です。ID は文字列（UUID）、日時は ISO 8601 で返ります。

課金について

書き込み・生成エンドポイント

投稿作成の例

curl -X POST https://posti.jp/v1/posts \
  -H "Authorization: Bearer posti_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","media_url":"https://.../pic.png","caption":"新商品です","targets":["<account_id>"]}'
# → {"post_id":"...","status":"queued"}

targets を省略すると連携済みの全アカウントへ配信されます。scheduled_at（posti が投稿する時刻）で予約もできます。

広告作成の例

Meta / Google / TikTok / X / Pinterest / LINEヤフー の6媒体に、商材（product_id）からAIで広告を生成して出稿できます。作成される広告は必ず PAUSED（停止）状態なので、内容を確認してから各媒体の管理画面で有効化します。

# 既定は dry_run=true（下書き案のプレビュー・課金なし）。実出稿は dry_run:false を明示。
curl -X POST https://posti.jp/v1/ads \
  -H "Authorization: Bearer posti_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"platform":"pinterest","product_id":"<UUID>","daily_budget_jpy":1000,"board_id":"<board>","n_variants":3,"dry_run":false}'

記事生成の例

prompt からAIで記事本文を生成し、下書き（記事ジョブ）を作成します。brand_id を渡すと、そのブランドのペルソナ＋ナレッジベース（KB）に接地して生成します（口調・知識が反映されます）。auto_post:true ＋ scheduled_at でWordPressへ予約公開もできます。

curl -X POST https://posti.jp/v1/articles \
  -H "Authorization: Bearer posti_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"初心者向けにNISAの始め方を解説する記事","brand_id":"<UUID>"}'
# → {"job_id":"...","status":"ready","title":"...","body_html":"..."}

生成した本文は body_html で返り、下書きジョブとして保存されます。body_html を直接渡した場合は生成せず下書き保存のみ（課金なし）。課金は実際に使ったトークン量に応じた従量です。

バッチ生成の例

複数のプロンプトを1回のリクエストで一括生成します。kind は image / video / text。件数分だけクレジットを消費するため、コンテンツの量産に向きます（1リクエスト最大10件）。

curl -X POST https://posti.jp/v1/generate/batch \
  -H "Authorization: Bearer posti_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","prompts":["夏の海のポスター","秋の紅葉のポスター","冬の雪景色のポスター"]}'
# → {"kind":"image","count":3,"results":[{"generation_id":"...","status":"generating"},...]}

image / video は各件が非同期ジョブになり、GET /v1/generations/{id} で結果を取得します。text は各件の本文が results[].text に同期で返ります。残高が不足すると、その時点で処理を打ち切ります。

読み取りエンドポイント

いずれも API キーの所有者にひも付くデータのみを返します（他ユーザーのデータは返りません）。課金はありません。共通で ?limit（1〜200・既定50）と ?offset によるページングに対応します。

例

# 直近30日の売上サマリ
curl -H "Authorization: Bearer posti_xxxxxxxx" \
  "https://posti.jp/v1/analytics/sales?days=30"
# → {"period_days":30,"since":"...","revenue_jpy":128000,"orders":9}

# 未対応の受信箱スレッドをLINEに絞って取得
curl -H "Authorization: Bearer posti_xxxxxxxx" \
  "https://posti.jp/v1/inbox/threads?channel_type=line&limit=20"

返却されるのは個人情報・秘密情報を除いた安全な項目のみです（アクセストークン・決済の生ペイロード・内部IDなどは含まれません）。

Webhook（イベント通知）

posti 側のイベントを外部URLへ通知できます。

1. サイドバーの 設定 → Webhook を開く。
2. 通知先URLと受け取るイベントを選び、作成する（署名検証用の secret が発行される）。
3. 「テスト送信」で疎通確認ができる。

通知できる主なイベント：

通知の本文は {"event": "...", "delivery_id": "...", "created_at": "...", "data": {...}} 形式で、ヘッダに X-Posti-Event と、secret 設定時は本文のHMAC-SHA256署名 X-Posti-Signature が付きます。data にはイベント別の情報（例: purchase.completed なら purchase_id / product_name / amount_jpy / email / provider / brand_id）が入ります。

Zapier / Make 連携

posti の API はキー認証の標準的な REST なので、Zapier・Make・n8n などのノーコードツールから接続できます。

トリガー（posti → 外部） — 2通り:

• ポーリング: GET /v1/purchases などの一覧を ?since= 付きで定期取得し、新着（新しい購入・リード・受信箱メッセージ・投稿）を検知する。
• Webhook（プッシュ）: 設定 → Webhook で通知先URLとイベントを登録すると、イベント発生時に posti から即時通知される（署名 secret 付き）。

アクション（外部 → posti） — 各 POST エンドポイントをそのまま呼び出す:

• 投稿を作成（POST /v1/posts）／記事を生成（POST /v1/articles）／広告を出稿（POST /v1/ads）／画像・動画・テキストを生成（POST /v1/generate/*・/v1/generate/batch）。

接続設定（汎用HTTPアクションの場合）:

1. 認証: HTTP ヘッダに Authorization: Bearer <APIキー> を設定。
2. トリガーは GET＋since（ポーリング）、またはWebhook受信。
3. アクションは各エンドポイントへ POST（JSON ボディ）。

レート制限

API キー単位でレート制限があります（目安: 1時間あたり1000リクエスト・1分あたり100リクエスト）。制限に達すると 429（rate limit exceeded）が返るので、時間を空けて再試行してください。

エラー

関連ページ

• SNS連携
• 設定（ドメイン・特商法・料金）