APISNS 投稿 API

仕上がった動画を予約する
ダッシュボードを開かずに

1 回の呼び出しで、レンダリング済みの動画を接続済みアカウントの指定した分に予約できます。カレンダーを読み返し、キューをステータスで絞り込み、実際に投稿された時刻は署名付き Webhook が知らせます。

POSThttps://autostud.ai/api/v1/actions/publishing.schedule_post

3 回の呼び出しで、レンダリングから投稿へ

投稿先は一度見つけるだけ。あとは好きなだけ予約できます。

  1. 1

    投稿先を見つける

    接続済みアカウントは API からは読み取り専用です。OAuth の情報はサーバーの外に出してはならないため、接続はダッシュボードで一度だけ行います。一覧を取得して ID を控えてください。

    export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    
    # Read-only on purpose: accounts are connected from the dashboard,
    # so the OAuth tokens never leave the server.
    curl "https://autostud.ai/api/v1/social_accounts?status=active&limit=10" \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY"
  2. 2

    投稿を予約する

    動画、アカウント、時刻、キャプション。呼び出しが返すのは予約済みの投稿であって、公開済みの投稿ではありません。真実の所在はあなたのスケジューラーのままです。

    curl -X POST https://autostud.ai/api/v1/actions/publishing.schedule_post \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: lighthouse-ep12-tiktok" \
      -d '{
        "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20",
        "account_id": "9a2c6f18-4b70-4d35-8e91-0f7d3c84b562",
        "scheduled_at": "2026-08-21T18:30:00.000Z",
        "caption": "Episode 12: the keeper who never slept #lighthouse"
      }'
  3. 3

    出ていくのを見届ける

    日ごとにまとまったカレンダーを読む、キューをステータスで絞る、あるいは post.published を受け取って問い合わせをやめる。失敗も同じ経路で、理由つきで届きます。

    curl -X POST https://autostud.ai/api/v1/actions/publishing.calendar \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "from": "2026-08-17", "to": "2026-08-24" }'
    
    # Need something more specific? The queue is a plain resource:
    curl "https://autostud.ai/api/v1/scheduled_posts?status=error&platform=tiktok" \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY"

予約投稿が受け取るもの

4 つのフィールド。レンダリング済みファイル、投稿先、時刻、そして言葉。

video_id

公開する動画。レンダリング済みである必要があります。キューが投稿するのはファイルであって、タイムラインではありません。

account_id

どの接続済みアカウントに送るか。1 投稿につき 1 つの宛先なので、失敗が他を巻き込むことはありません。

scheduled_at

いつ出すか。プラットフォームが受け付ける範囲であれば、今すぐでも構いません。

caption

添えるキャプション。ハッシュタグやメンションは入力したまま、その中を一緒に運ばれます。

キューは両方向から読めます

カレンダーは「今週何が出るか」に答え、リソースは「この動画はどうなったか」に答えます。どちらも絞り込めるので、追加のエンドポイントなしでダッシュボードが作れます。

GET /api/v1/social_accountsGET /api/v1/scheduled_postspublishing.calendar

本当に投稿された時を知る

予約は約束であって結果ではありません。post.published はプラットフォームが受理した時点で発火します。部分的な公開でも発火し、その場合はアカウントごとの結果がペイロードに入ります。

post.publishedpost.failed

開発者が最初に聞くこと

API からアカウントを接続できますか?

できません。これは意図した設計です。OAuth トークンがサーバーの外に出ないよう、接続はダッシュボードで行います。API にできるのは一覧取得と投稿だけです。

プラットフォームに拒否されたらどうなりますか?

投稿はエラー状態でキューに残り、post.failed が理由つきで発火します。あなたの知らないところで黙って再試行することはありません。

同じ動画を複数のアカウントに投稿できますか?

できます。宛先ごとに 1 回ずつ呼び出してください。分けておくことで、あるプラットフォームがキャプションを拒否しても他がすべて巻き添えになりません。

カレンダー表示はどう作りますか?

publishing.calendar が 2 つの日付の間の予約投稿を日ごとにまとめて返します。もっと細かく見たい場合は scheduled_posts リソースを status、platform、video_id で絞り込んでください。

作りはじめませんか?

バズる動画を数分で。無料トライアルにクレジットカードは不要です。

安全な決済
すぐに利用可能
いつでも解約可能