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

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 の動画と写真投稿を公開します。

3 levels

写真投稿で公開アカウントが選べる公開範囲は、PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS、SELF_ONLY です。

FOLLOWER_OF_CREATOR

非公開アカウントが PUBLIC_TO_EVERYONE の代わりに受け取る公開範囲は、フォロワーのみに表示されます。

false

disable_comment、disable_duet、disable_stitch の既定値は false です。設定しなければ、コメント、Duet、Stitch は有効のままです。

1080 x 1920

動画のカスタムカバー画像の上限サイズです。360 x 360 ピクセル以上で、20 MB まで。

Paid partnership

is_branded_content を true にするとラベルが付き、is_brand_organic も true のときはこちらが優先されます。

privacy_level

写真投稿の post_info の必須項目で、GET /business/video/settings/ がアカウントに返す選択肢に限られます。

どの投稿エンドポイントがどの設定を受け取りますか?

/business/video/publish/ と /business/photo/publish/ は一部の設定を共有し、他は異なります。大半は post_info の中にありますが、custom_thumbnail_url と photo_cover_index はリクエスト本文の最上位にあります。TikTok のリファレンスが挙げる形で並べます。ドキュメントに記載がない設定には「No field」と示します。

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_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:アカウントが投稿できる動画の最長時間です。これより長い動画は失敗します。
Read an account's post settings
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 の認証済みメディアルートに通す呼び出しです。

Reading the settings from your own code
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 が並びます。
EasyCoexistence で実現する

キャプション、写真投稿のタイトル、コメントのオンとオフを指定でき、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 監視

確認日