API で TikTok の投稿の公開状況を確認する方法
API 経由の投稿は TikTok 側で非同期に公開されます。公開リクエストは share_id を返し、その ID を publish_id として GET /business/publish/status/ に渡すと、投稿の現在の状態がわかります。状態は、TikTok がファイルを取得している間は PROCESSING_DOWNLOAD、審査を通過して公開されると PUBLISH_COMPLETE、失敗した場合は frame_rate_check_failed などの理由とともに FAILED になります。
EasyCoexistence は publish_tiktok_post で TikTok に投稿し、get_tiktok_publish_status で各投稿を追跡します。
PUBLISH_COMPLETE の後に投稿 ID が表示されるまでの時間。見つからない場合、TikTok は 3 分後に再試行するよう案内しています。
1 GB の投稿ファイルのダウンロードにかかる TikTok の一般的な目安。実際の時間はファイルサイズとネットワークによって変わります。
アップロード完了後、投稿が公開されるまでの通常の最長待ち時間。手動審査の場合はさらに長くかかることがあります。
TikTok が video_pull_failed または photo_pull_failed として投稿を失敗扱いにする、ダウンロードのタイムアウト。
なぜ TikTok の投稿を追跡する必要があるのですか?
TikTok は投稿をバックグラウンドで公開するためです。公開リクエストはタスクを開始し、すぐに share_id を返します。その後 TikTok は URL からファイルをダウンロードし、形式を確認し、審査を行ってから投稿を公開します。リクエスト自体が成功した後でも、投稿が失敗することがあります。
ステータスにはどのような種類がありますか?
GET /business/publish/status/ は、アカウントの business_id と、publish_id として指定した share_id を受け取り、次の 4 つのうちいずれかのステータスを返します:
PROCESSING_DOWNLOAD:TikTok が URL からコンテンツをダウンロードしています。PUBLISH_COMPLETE:投稿が審査を通過して公開されました。公開閲覧可能になると、post_idsに投稿 ID が表示されます。- FAILED:公開が停止されました。理由は reason に示されます。
SEND_TO_USER_INBOX:下書きがアップロードされ、TikTok がクリエイターの受信トレイに通知しました。下書きにのみ適用されます。
公開にはどのくらい時間がかかりますか?
TikTok は固定の時間を示していません。ダウンロード時間はファイルサイズとネットワークによって変わります。TikTok の一般的な目安では、1 GB のファイルなら 30 分で十分で、上限は 1 時間です。その後、投稿は通常 2 分以内に公開されます。手動審査が必要な場合はさらに遅くなります。投稿 ID がステータスに表示されるまで、さらに最大 3 分かかることがあります。
失敗理由はそれぞれ何を意味しますか?
reason は、投稿を止めた原因を示します。ファイルの修正が必要なものもあれば、再試行で解決できるものもあります:
file_format_check_failed、duration_check_failed、frame_rate_check_failed、picture_size_check_failed:ファイルが形式のルールに違反しています。TikTok はこれらを再試行不可として扱います。video_pull_failed、photo_pull_failed:TikTok がファイルをダウンロードできなかった、または 1 時間以内にダウンロードできませんでした。URL が公開アクセス可能になってから再試行してください。- internal:TikTok のサービスの一部が利用できませんでした。再試行しても問題ありません。
spam_risk_too_many_posts、spam_risk、spam_risk_text:投稿の量、動作、またはキャプションの内容を理由に、TikTok が投稿を停止しました。auth_removed:処理中にアカウントがアプリへのアクセス権を取り消しました。TikTok は再試行しないよう案内しています。spam_risk_user_banned_from_posting:アカウントが新規投稿を禁止されています。
投稿 ID は何のために使いますか?
後から投稿を見つけるためです。TikTok のリファレンスでは、投稿 ID を /business/video/list/ の filters.video_ids に渡して、投稿の指標を読み取ります。コメント用の API では、アカウントのビデオ一覧にある投稿の item_id を video_id として渡します。これは EasyCoexistence のコメントツールが post_id として受け取る値でもあります。
EasyCoexistence は投稿をどのように追跡しますか?
publish_tiktok_post は TikTok の share_id を返し、TikTok が投稿を処理中であることを伝えます。get_tiktok_publish_status はその share_id を受け取り、TikTok の現在のステータスを、理由がある場合はその理由とともに返します。すぐではなく、数分後に AI へ再確認を依頼してください。
よくある間違い
- まだ何も表示されないからといって、投稿を再度公開しないでください。最初の呼び出しはタスクを開始しただけなので、投稿を再送する前にそのステータスを確認してください。
- post_ids がない PUBLISH_COMPLETE をエラーとして扱わないでください。ID が表示されるまでさらに最大 3 分かかることがあるため、その時点で再確認してください。
- 同じファイルで形式エラーを再試行しないでください。file_format_check_failed などのチェックエラーには、修正したファイルが必要です。
- ダウンロード中に URL をオフラインにしないでください。TikTok はファイルを取得できない場合、video_pull_failed または photo_pull_failed で投稿を失敗させます。
Claude、ChatGPT、または独自のコードから操作でき、AI は TikTok の現在のステータスと失敗理由をそのまま確認できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
TikTok の share_id とは何ですか?
動画および写真の公開エンドポイントが返す、公開タスクの ID です。ステータスの呼び出しでは publish_id として渡します。
TikTok の公開ステータス用の Webhook はありますか?
はい。/business/webhook/update/ で event_type VIDEO を指定して登録したアプリは、繰り返しのステータス確認の代わりに、TikTok の投稿公開イベントを受け取ります。例えば、理由と publish_id を含む post.publish.failed などです。
公開済みなのに投稿 ID がまだないのはなぜですか?
PUBLISH_COMPLETE の後、post_ids が返るまで最大 3 分かかることがあります。また、post_ids は公開閲覧可能な投稿に対してのみ返されます。
失敗した TikTok の投稿は再試行できますか?
理由によります。ダウンロードおよび内部エラーは再試行できます。形式、長さ、フレームレート、画像サイズのエラーには、修正したファイルが必要です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日