API で TikTok クリエイターの下書きに動画を送信する
TikTok の API は、Content Posting API の /v2/post/publish/inbox/video/init/ でアップロードの流れを使い、動画をクリエイターの下書きに送ります。この呼び出しには video.upload スコープが必要で、TikTok はクリエイターにインボックスの通知を送り、クリエイターはアプリで編集して投稿できます。API for Business も同様に、/business/video/publish/ の upload_to_draft で行い、写真投稿では is_draft を使います。
easyCoexistence は、Claude、ChatGPT、または独自のプラットフォームから publish_tiktok_post を使って TikTok の動画と写真投稿を公開します。
TikTok の定義では、コンテンツを下書きとしてクリエイターのアカウントに共有し、TikTok 内で編集・投稿できるようにするスコープ。
任意の 24 時間内に Content Posting API が許可する保留中の共有の最大数。TikTok がスパム抑制のために設定する上限です。
ステータス /business/publish/status/ は、下書きがアップロードされ、TikTok がクリエイターのインボックスに通知したことを報告します。
ユーザーアクセストークンごとに Content Posting API のアップロードエンドポイントへ送信できるリクエストの数。
/business/video/publish/ で upload_to_draft が true の場合に、post_info の他のフィールドがどうなるか。
下書きは直接投稿とどう違いますか?
誰が「投稿」を押すかが違います。直接投稿は TikTok が処理を終えるとすぐに公開されます。下書きはクリエイターの TikTok インボックスに届き、クリエイターがそれを開いて好きに編集し、投稿したときにだけ公開されます。この違いは TikTok の両方の投稿 API に共通しています:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Content Posting API では下書きをどうアップロードしますか?
https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ に POST します。リクエストには video.upload を持つユーザーアクセストークンと source_info オブジェクトを含めます。PULL_FROM_URL では、アプリが検証済みのドメインまたは URL プレフィックスから TikTok が動画を取得します。FILE_UPLOAD では upload_url が返され、そこへファイルを PUT リクエストで分割して送信します。返された publish_id は /v2/post/publish/status/fetch/ に渡します。写真は post_mode を MEDIA_UPLOAD に設定して /v2/post/publish/content/init/ を使います。TikTok は、アプリからユーザーに、インボックスの通知を開いて TikTok で編集を続けるよう案内することを求めています:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Content Posting API の下書きにはどの上限がありますか?
TikTok はアップロードのリファレンスで以下を定めています。該当する場合は、いずれも init 呼び出しから返されます:
- 保留中の下書き:任意の 24 時間内に保留中の共有は最大 5 件です。それを超えると HTTP 403 と
spam_risk_too_many_pending_shareが返されます。 - リクエスト:ユーザーアクセストークンごとに 1 分あたり 6 件です。超えると HTTP 429 と
rate_limit_exceededが返されます。 - スコープ:video.upload のないトークンには、HTTP 401 と
scope_not_authorizedが返されます。 - メディア:アプリが検証していないドメインまたはプレフィックスからの
PULL_FROM_URLには、HTTP 403 とurl_ownership_unverifiedが返されます。
API for Business では下書きをどうアップロードしますか?
公開用のエンドポイントを使い、post_info にフィールドを 1 つ追加します。/business/video/publish/ で upload_to_draft を true にすると、動画は下書きとして送られ、TikTok は post_info の他のフィールドを無視します。/business/photo/publish/ では、is_draft によってタイトルとキャプションだけが残ります。どちらもアカウントのトークンに video.upload が必要で、これは /tt_user/token_info/get/ で一覧できます。含まれていない場合は、オーナーがアプリを再度認可して下書きのアップロードを承認します。メディアは引き続き検証済み URL に置かれ、ステータスは SEND_TO_USER_INBOX となり、クリエイターはインボックスの通知から下書きを見つけます:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'クリエイターは下書きをどうしますか?
TikTok で仕上げます。インボックスの通知を開くと、アップロードされた動画または写真が TikTok のエディターで開き、クリエイターが確認、編集して投稿します。Content Posting API では、クリエイターが下書きから投稿すると、ステータスは SEND_TO_USER_INBOX から PUBLISH_COMPLETE に変わります。また TikTok は、1 つの下書きから複数の投稿が作られる場合があることを明記しています。
easyCoexistence は下書きを送信しますか?
いいえ。publish_tiktok_post は公開します。upload_to_draft も is_draft も指定せずに /business/video/publish/ または /business/photo/publish/ を呼び出すため、TikTok が処理を終えるとすぐに投稿が公開されます。確認のために投稿を保留するには、scheduled_at で予約します。予約は 1 分後から 90 日後までの日時を指定できます。予約された投稿は投稿画面の「今後の予定」に表示されます。update_scheduled_post で時刻、キャプション、写真投稿のタイトルを変更でき、cancel_scheduled_post で公開前に取り消せます。
よくある間違い
- 下書きを送るために video.publish を要求すること。下書きには video.upload が必要で、これは TikTok がコンテンツをクリエイターのアカウントへ下書きとして共有すると説明するスコープです。
- API for Business で動画の下書きにキャプションを設定すること。upload_to_draft が true の場合、TikTok は post_info の残りを無視します。
- クリエイターが投稿するより速く下書きをアップロードすること。Content Posting API は、24 時間内に保留中の共有が 5 件に達すると spam_risk_too_many_pending_share で止まります。
- ユーザーにインボックスへの案内を伝えないこと。TikTok は、アプリからユーザーにインボックスの通知を開いて投稿を完成させるよう伝えることを求めています。
今すぐでも、最大 90 日先の日時でも予約できます。公開されるまで、予約された各投稿は投稿画面に表示されます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
TikTok API で動画を下書きとして保存できますか?
はい。アップロードの流れで動画はクリエイターの TikTok インボックスに入り、クリエイターが編集して投稿します。トークンには video.upload スコープが必要です。
API で送った下書きはどこに表示されますか?
TikTok アプリ内の、インボックスの通知からです。通知を開くと動画が TikTok のエディターで開き、クリエイターが仕上げます。
TikTok の下書きにキャプションを残せますか?
API for Business では、写真の下書きはタイトルとキャプションを保持します。動画の下書きでは、post_info の他のフィールドは取り除かれます。
1 つの TikTok 下書きから複数の投稿を作れますか?
はい。TikTok は、1 つの下書きから複数の投稿が作られる場合があると明記しています。Content Posting API では、クリエイターが下書きから投稿すると、ステータスは PUBLISH_COMPLETE に変わります。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日