ログイン無料トライアルを開始
easyCoexistence 公式 API

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 で各投稿を追跡します。

3 min

PUBLISH_COMPLETE の後に投稿 ID が表示されるまでの時間。見つからない場合、TikTok は 3 分後に再試行するよう案内しています。

30 min

1 GB の投稿ファイルのダウンロードにかかる TikTok の一般的な目安。実際の時間はファイルサイズとネットワークによって変わります。

2 min

アップロード完了後、投稿が公開されるまでの通常の最長待ち時間。手動審査の場合はさらに長くかかることがあります。

1 hour

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 で投稿を失敗させます。
EasyCoexistence で実現する

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 監視

確認日