予約投稿APIAPI

フィールド1つで予約投稿

今すぐ公開する場合と同じボディにschedule_atのタイムスタンプを加えるだけで、FoPostがその時刻までキューで保持します。公開の瞬間まですべて編集でき、配信結果はアカウントごとに報告されます。

APIキーを取得ドキュメントを読む
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

タイムスタンプ1つ

未来の任意のISO 8601時刻を指定できます。キューが受け取り、予定どおりに公開します。

送信まで編集可能

キューに残っている投稿なら、テキスト、メディア、アカウント、時刻をPUTで変更できます。

アカウントごとの配信

公開されると、各アカウントがステータスとパーマリンクを個別に返します。

キュー

1週間分の投稿をスクリプト1つで計画

コンテンツをループで回し、それぞれに時刻を決めて投稿を作成します。キューはFoPost側で動くため、リクエストが返ればすぐに自分のプロセスを終了できます。予約済みの投稿はいつでも一覧で確認できます。

投稿リファレンスを読む
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

ステータスで絞り込み

クエリパラメータ1つで、下書き、予約済み、公開済み、失敗した投稿を一覧できます。

ラベル

キャンペーンごとに投稿にタグを付け、キューをラベルで絞り込めます。

ワークスペースごと

キーが見られるのは1つのワークスペースだけなので、クライアント同士のキューが混ざることはありません。

調整

公開前に移動、書き換え、キャンセル

計画は変わるものです。予約投稿をPUTすれば、時刻、テキスト、メディア、対象アカウントを変更できます。キャンセルすれば「キャンセル済み」となり配信されません。完全に削除することもできます。キューが処理を始めるまで、何もロックされません。

PUTエンドポイントを見る
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "schedule_at": "2026-09-01T14:00:00Z" }'

予約変更

schedule_atを変更すると、キューが投稿を新しい時刻に移動します。

コンテンツの差し替え

キュー内の投稿のcontent配列やメディアIDを置き換えられます。

キャンセルまたは削除

ほかの投稿に影響を与えずに、1件だけキューから外せます。

確認

ポーリングなしで公開を把握

予約時刻になると、投稿はアカウントごとの配信に分かれます。Webhookを登録すれば、それぞれについてdelivery.publishedまたはdelivery.failedが発行されます。プル型が好みなら、deliveriesエンドポイントをポーリングすることもできます。

開発を始める
投稿カレンダーに並んだ1か月分の予約投稿

確定時にWebhook

delivery.publishedには、投稿ID、アカウント、パーマリンクが含まれます。

再試行

ネットワークの一時的なエラーは、失敗を報告する前にバックオフ付きで再試行します。

公開後は分析

公開後は、同じ投稿IDでAnalytics APIからインプレッションとエンゲージメントを取得できます。

予約投稿APIに関するよくある質問

どれくらい先まで予約できますか？

期限はありません。未来のISO 8601タイムスタンプならどれでも受け付け、その時刻までキューが投稿を保持します。

schedule_atのタイムゾーンは？

末尾がZのUTCのISO 8601タイムスタンプを送ってください。送った値がそのまま実行され、サーバー側での変換は行いません。

予約後に投稿を編集できますか？

はい。まだ公開されていない投稿なら、時刻を含むどのフィールドもPUTで変更できます。公開後の編集はレコードに反映され、ネットワークから消すには削除を使います。

公開時刻に自分のサーバーがダウンしていたら？

何も変わりません。キューは自社のインフラではなくFoPostの中で動くため、プロセスが動いているかどうかに関係なく投稿は公開されます。

一部のアカウントだけに予約できますか？

はい。accounts配列が対象リストです。投稿を届けるアカウントだけを含めれば、それぞれに個別の配信レコードが作られます。

レート制限はありますか？

はい、キーごとに毎分100リクエストです。1週間分の投稿をスクリプト1つで予約しても、余裕で収まります。

今日から予約投稿APIで開発を

無料で始められ、API全体が含まれます。キーを作成すれば、数分で最初の呼び出しができます。

APIキーを取得