API経由のTikTok投稿設定:公開範囲、コメント、Duet、Stitch
TikTok の API for Business では、投稿の設定を投稿リクエストで指定します。大半は post_info の中に含まれます。動画では disable_comment、disable_duet、disable_stitch、thumbnail_offset または custom_thumbnail_url によるカバー、is_brand_organic と is_branded_content のラベル、is_ai_generated を指定できます。写真投稿では privacy_level、disable_comment、同じブランドラベル、auto_add_music を指定できます。GET /business/video/settings/ は、アカウントごとに許される値を返します。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから publish_tiktok_post で TikTok の動画と写真投稿を公開します。
写真投稿で公開アカウントが選べる公開範囲は、PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS、SELF_ONLY です。
非公開アカウントが PUBLIC_TO_EVERYONE の代わりに受け取る公開範囲は、フォロワーのみに表示されます。
disable_comment、disable_duet、disable_stitch の既定値は false です。設定しなければ、コメント、Duet、Stitch は有効のままです。
動画のカスタムカバー画像の上限サイズです。360 x 360 ピクセル以上で、20 MB まで。
is_branded_content を true にするとラベルが付き、is_brand_organic も true のときはこちらが優先されます。
写真投稿の post_info の必須項目で、GET /business/video/settings/ がアカウントに返す選択肢に限られます。
どの投稿エンドポイントがどの設定を受け取りますか?
/business/video/publish/ と /business/photo/publish/ は一部の設定を共有し、他は異なります。大半は post_info の中にありますが、custom_thumbnail_url と photo_cover_index はリクエスト本文の最上位にあります。TikTok のリファレンスが挙げる形で並べます。ドキュメントに記載がない設定には「No field」と示します。
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
アカウントは何を許可していますか?
business_id を付けて GET /business/video/settings/ を呼び出すと、アカウントの投稿に対する上限が返ります。TikTok は一覧にある値しか受け付けないため、投稿前に確認してください。
privacy_level_options:公開アカウントではPUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS、SELF_ONLY。非公開アカウントではFOLLOWER_OF_CREATOR、MUTUAL_FOLLOW_FRIENDS、SELF_ONLY。comment_disabled:アカウントが誰からもコメントを受け付けないとき true になり、その場合disable_commentは true しか受け付けません。duet_disabledとstitch_disabled:アカウントが Duet や Stitch を「自分のみ」に制限しているか非公開のとき true になり、対応するスイッチは true しか受け付けません。max_video_post_duration_sec:アカウントが投稿できる動画の最長時間です。これより長い動画は失敗します。
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}投稿を見られるのは誰ですか?
写真投稿では、送信した privacy_level で決まります。PUBLIC_TO_EVERYONE は TikTok 利用者かどうかを問わず誰でも、MUTUAL_FOLLOW_FRIENDS はアカウントがフォローバックしているフォロワー、FOLLOWER_OF_CREATOR は非公開アカウントのフォロワー、SELF_ONLY は本人のみです。動画エンドポイントには公開範囲の項目がなく、公開の動画投稿を行います。「友達」または「自分のみ」に設定した投稿は、embed_url からも視聴できません。
コメント、Duet、Stitch はどう動きますか?
それぞれはスイッチで、true に設定するとその機能をオフにします。disable_comment は両方のエンドポイントにあり、disable_duet と disable_stitch は動画のみにあります。すべて既定値は false で、機能はオンのままです。ただし、アカウント自身の公開設定が許す範囲内に限られます。誰からもコメントを受け付けないアカウント、あるいは Duet や Stitch を「自分のみ」に制限しているアカウントは、そのスイッチを true にしないと投稿できません。
カバーはどう選ばれますか?
動画では2つの方法があります。post_info.thumbnail_offset は時間(ミリ秒)でフレームを選びます。既定値は 0 で、最も近いフレームに切り上げられます。動画の終わりを超える時間を指定すると、失敗を通知する Webhook が送られ、動画は投稿されません。リクエスト本文の最上位にある custom_thumbnail_url は画像を指定し、この場合 TikTok は offset を無視します。写真投稿では、photo_cover_index が画像の一つを 0 から数えて選びます。
- カスタムカバー画像:JPG、JPEG、WebP、PNG で、20 MB まで。
- サイズ:360 x 360 ピクセル以上、1080 x 1920 または 1920 x 1080 まで。
- 場所:アプリに対して認証済みのドメインまたは URL プレフィックス。動画本体と同じ条件です。
ブランドラベルは何を意味しますか?
TikTok が投稿に表示する開示表示です。is_brand_organic を true にすると「プロモーションコンテンツ」と表示されます。アカウント自身の事業を宣伝する投稿に使います。is_branded_content を true にすると「有料パートナーシップ」と表示され、ブランドとの有料提携による投稿に使います。両方が true のときはこちらが優先されます。is_branded_content を付けた動画では、tto_invite_link で、アカウントが参加している TikTok One Creator Marketplace のキャンペーンに投稿をリンクできます。
post_info にはほかにどんなオプションがありますか?
ほかにもあり、それぞれ受け取るエンドポイントに記載があります。
is_ai_generated(動画):投稿に AI 生成のラベルを付けます。投稿後は変更できません。location_idとlocation_name:GET /business/publish/location/ で見つけた位置情報タグです。music_sound_info:ID で指定する商用サウンドです。動画では音量(0 から 100)と、開始・終了時刻(ミリ秒)も指定します。auto_add_music(写真投稿):おすすめの音楽を追加します。あとで TikTok アプリから変更できます。upload_to_draftまたはis_draft:video.upload スコープを使い、動画をクリエイターの受信箱に下書きとして送ります。is_ads_only(動画):プロフィールに表示されない「広告でのみ表示」投稿として公開します。
publish_tiktok_post はどの設定を指定しますか?
リクエストから受け取るのは3つです。キャプション、写真投稿のタイトル、disable_comment。easyCoexistence は is_brand_organic と is_branded_content を false で送信し、写真投稿は最初の画像をカバーにして PUBLIC_TO_EVERYONE で公開し、動画のそれ以外の設定は送りません。そのため TikTok の既定値が適用されます。disable_duet と disable_stitch は false、thumbnail_offset は 0、is_ai_generated は false です。
ほかの設定はどう送りますか?
ご自身のコードから、get_social_credentials のアカウントのトークンと business_id を使い、business/ 配下の Business API パスを呼び出します。business/video/settings/ への GET で、アカウントの上限を読み取ります。business/video/publish/ または business/photo/publish/ への POST は、リファレンスに記載された本文を完全に含められ、メディア URL を含めてそのまま TikTok に渡ります。そのため、メディア URL はアプリに対して認証済みのドメインまたは URL プレフィックスに置く必要があります。publish_tiktok_post は、あなたのリンクを easyCoexistence の認証済みメディアルートに通す呼び出しです。
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>よくある間違い
- 動画エンドポイントで privacy_level が使えると考えること。動画エンドポイントは公開投稿を行い、リファレンスに公開範囲の項目はありません。写真投稿は privacy_level を受け付けます。
- コメントを受け付けないアカウントでコメントを有効にすること。comment_disabled が true のとき、TikTok は disable_comment を true としてのみ受け付けます。
- thumbnail_offset を動画の終わりを超えて設定すること。TikTok は失敗を通知する Webhook を送り、動画は投稿されません。
- 非公開アカウントに PUBLIC_TO_EVERYONE を送ること。その privacy_level_options には、代わりに FOLLOWER_OF_CREATOR、MUTUAL_FOLLOW_FRIENDS、SELF_ONLY が並びます。
キャプション、写真投稿のタイトル、コメントのオンとオフを指定でき、get_social_credentials は、アカウントの許可された設定を読み取るためのトークンをご自身のコードに渡します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
TikTok の API で非公開の動画を投稿できますか?
動画エンドポイントでは投稿できません。公開投稿のみを行うためです。写真投稿は privacy_level を受け付け、SELF_ONLY も含まれます。動画は upload_to_draft を使うと、クリエイターの受信箱に下書きとして送れます。
API で Duet と Stitch をオフにするには?
/business/video/publish/ で post_info.disable_duet と post_info.disable_stitch を true に設定します。アカウントがすでに制限している場合、TikTok は true のみを受け付けます。
TikTok API で位置情報タグを追加できますか?
はい。post_info は location_id と location_name を受け付けます。位置情報タグは GET /business/publish/location/ で見つけます。
is_brand_organic と is_branded_content の違いは何ですか?
is_brand_organic はアカウント自身の事業向けに「プロモーションコンテンツ」ラベルを付けます。is_branded_content は「有料パートナーシップ」ラベルを付け、両方が true のときはこちらが優先されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日