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

API で TikTok の投稿に音楽を追加する

TikTok の API for Business では、Commercial Music Library の楽曲を追加できます。動画と写真の投稿では post_info.music_sound_info に楽曲の music_sound_id を指定し、動画ではさらに楽曲の音量、ミリ秒単位の開始と終了、動画自体の音量も指定できます。写真投稿では推奨音楽のための auto_add_music も使えます。楽曲 ID は GET /discovery/cml/trending_list/ から取得します。

easyCoexistence は、Claude、ChatGPT、または自分のコードから publish_tiktok_post を使って、TikTok の動画と写真投稿を公開します。

100

/discovery/cml/trending_list/ が返す人気楽曲です。いずれもオーガニックコンテンツと広告制作向けに事前許諾済みです。

0 to 100

music_sound_volume と video_original_sound_volume の範囲です。API 経由では両方とも既定値が 0 で、TikTok アプリでは 50 から始まります。

1 million

TikTok の Commercial Music Library の楽曲です。企業が TikTok 上の商用活動に使える、事前許諾済みのグローバルライブラリです。

TikTok only

権利者が別途許可しない限り、TikTok の広告用音楽リストの楽曲で作られたクリエイティブが配信される場合があります。

DIRECT_POST

developers.tiktok.com によると、Content Posting API の写真エンドポイントで auto_add_music が適用される唯一の post_mode です。

TikTok の公開エンドポイントは、どの音楽フィールドを受け付けますか?

どちらのエンドポイントも、音楽は post_info 内の music_sound_info に入れ、Commercial Music Library の ID で楽曲を指定します。違いとして、動画のエンドポイントには音量の調整項目があり、写真のエンドポイントには TikTok に音楽を選ばせるスイッチがあります。TikTok のリファレンスに従って並べると次のとおりです:

Video postPhoto post
The trackmusic_sound_info.music_sound_idmusic_sound_info.music_sound_id
Track volumemusic_sound_volume, 0 to 100, required with a trackNo field
Part of the trackmusic_sound_start and music_sound_end, in millisecondsNo field
The video's own soundvideo_original_sound_volume, 0 to 100Not applicable
Recommended musicNo fieldauto_add_music, false by default
As a draftupload_to_draft drops the rest of post_infois_draft keeps only the title and caption

動画に楽曲を追加するにはどうしますか?

POST /business/video/publish/ の post_info 内に music_sound_info を送ります。このオブジェクトを入れると、music_sound_id と music_sound_volume が必須になります。music_sound_start と music_sound_end で、楽曲の使う部分をミリ秒で指定します。既定では楽曲の先頭から動画の全長までが対象になるため、2 秒の動画では楽曲の最初の 2,000 ミリ秒が使われます。動画自体の音声が重要な場合は、video_original_sound_volume も設定してください。既定値は 0 です:

A 15-second video with seconds 15 to 30 of a library track
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/launch.mp4",
    "post_info": {
      "caption": "Our new blend is here #coffee",
      "is_brand_organic": false,
      "is_branded_content": false,
      "music_sound_info": {
        "music_sound_id": "<SONG_CLIP_ID>",
        "music_sound_volume": 40,
        "music_sound_start": 15000,
        "music_sound_end": 30000,
        "video_original_sound_volume": 80
      }
    }
  }'

楽曲 ID はどこから取得しますか?

GET /discovery/cml/trending_list/ から取得します。このエンドポイントは Discovery API のもので、TikTok アカウントのアクセストークンと business_id を受け取ります。一方、Discovery のハッシュタグのエンドポイントは広告主のものを受け取ります。TikTok のリファレンスでは Creative Management の Discovery 権限の下に分類されています。最大 100 件の人気楽曲を返し、それぞれに名前、アーティスト、長さ、順位、ジャンル、期限切れにならない preview_url、最大 30 日分の trending_history が含まれます。full_duration_song_clip と trending_song_clip にはそれぞれ song_clip_id があり、これが TikTok の定める music_sound_id の値です:

  • genre: 既定値は ALL。POP、LATIN、LO-FI、SERTANEJO など 100 を超える値から選べます。
  • country_code: 既定値は US。date_range: 既定値は 7DAY で、1DAY、30DAY、90DAY も指定できます。
  • /discovery/cml/video_list/: 楽曲の commercial_music_id と country_code を指定して、その楽曲を使う急上昇動画の上位 20 件を返します。
Popular pop tracks in Brazil over the last 7 days
curl -G 'https://business-api.tiktok.com/open_api/v1.3/discovery/cml/trending_list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'genre=POP' \
  --data-urlencode 'country_code=BR' \
  --data-urlencode 'date_range=7DAY'

写真投稿で音楽はどのように付けられますか?

POST /business/photo/publish/ には 2 つの方法があります。auto_add_music を true にすると、TikTok が推奨音楽を追加します。オーナーは後から TikTok アプリで変更できます。music_sound_info.music_sound_id を指定すると、ライブラリの特定の楽曲を使えます。写真には音量、開始、終了のフィールドはありません。developers.tiktok.com では、Content Posting API の写真エンドポイントに独自の auto_add_music があり、post_mode が DIRECT_POST の場合にのみ適用されます。その direct-post 動画エンドポイントには、音楽フィールドが記載されていません。

Commercial Music Library はビジネスアカウントにとってどういう意味ですか?

ビジネスアカウントが使ってよい音楽を意味します。TikTok のビジネスヘルプセンターによると、このライブラリは事前許諾済みの世界規模のコレクションで 100 万曲あり、企業は一般の音楽ライブラリを商用利用できないとされています。オーガニックコンテンツ(デュエット、リアクション、スティッチを含む)、動画広告、ブランドコンテンツでは、Commercial Music Library を使うよう案内されています。ビジネスアカウントでは、アプリの「Add Sound」にライブラリの音源しか表示されません。music_sound_id もライブラリの ID を受け取るため、API も同じ線引きをしています。

API では音楽について何ができませんか?

TikTok のリファレンスに記載されているとおり、いくつかの操作はフィールドの範囲外です:

  • TikTok の一般ライブラリから音源を指定する: music_sound_id は Commercial Music Library の ID のみを受け付けます。
  • タイトルでライブラリを検索する: /discovery/cml/trending_list/ は人気楽曲をジャンル、国、期間で絞り込みます。
  • 下書きで音楽を保持する: upload_to_draft では TikTok が post_info の他の項目を無視し、is_draft ではタイトルとキャプションだけが残ります。
  • オーガニック投稿で自分の楽曲を使う: /file/music/upload/ は advertiser_id のもとで広告クリエイティブ用の音楽を追加します。TikTok の注意書きでは、著作権の責任はアップロードした側にあるとされています。

回避策はありますか?

3 つあり、いずれも TikTok のリファレンスに記載された機能に基づいています。加えて、考慮すべきリスクが 1 つあります:

  • ファイルに音楽をミックスする: TikTok の制約では動画は音声付きの映像コンテンツとして扱われるため、ミックスされた音声は動画と一緒に配信されます。権利を持つ音声を使ってください。
  • 下書きを送る: upload_to_draft または is_draft と video.upload スコープを使うと、投稿はクリエイターの TikTok の受信トレイに届き、アプリで編集して投稿できます。
  • 写真投稿では TikTok に選ばせる: auto_add_music は推奨音楽を追加し、オーナーは後から TikTok アプリで差し替えられます。
  • ミックスされた音声のリスク: TikTok の投稿一覧のリファレンスは、投稿がフィルタリングされる主な理由として、音楽の著作権侵害を挙げています。

楽曲が再生回数に貢献したかどうかは、どう確認しますか?

impression_sources で確認します。これは /business/video/list/ のフィールドで、投稿の視聴者がどこから見つけたかを順位付けします。値の一つ Sound は、サウンドページ経由の再生を表します。video.insights スコープが必要で、他の数値と同様に 24〜48 時間遅れて反映されます。easyCoexistence では、metrics に impression_sources を指定すると、get_social_insights がアカウントの直近 20 件の投稿のうち 1 件について返します。object_id には投稿の item_id を指定します。

easyCoexistence は音楽をどう扱いますか?

ファイルに既にある音声をそのまま公開します。publish_tiktok_post は、即時でも scheduled_at 指定でも、キャプション、写真投稿のタイトル、コメント設定を送ります。music_sound_info も auto_add_music も含めないため、動画は元のサウンドトラックを保持し、写真投稿は音楽なしで配信されます。自社のコードは、get_social_credentials のトークンを使って business/video/publish/ に music_sound_info 付きで POST できますが、そのボディは video_url を含めて書かれたまま TikTok に届きます。TikTok は、アプリで検証されたドメインまたは URL プレフィックスからのみメディアを取得します。/discovery/ のパスは広告主のトークンを受け取るため、楽曲一覧はアカウントのトークンの範囲外です。

よくある間違い

  • 楽曲を追加するときに video_original_sound_volume を省略する。API 経由では既定値が 0 ですが、TikTok アプリでは両方の音声が 50 から始まるため、動画自体の音声が重要な場合は必ず設定してください。
  • music_sound_id に楽曲の名前や preview_url を渡す。TikTok のリファレンスでは、full_duration_song_clip または trending_song_clip の song_clip_id を渡すよう定めています。
  • 広告主のトークンで /discovery/cml/trending_list/ を呼ぶ。楽曲のエンドポイントは、Accounts API と同じく TikTok アカウントのトークンと business_id を受け取ります。
  • 再生時間 0 を壊れた楽曲とみなす。TikTok は、より長い楽曲の一部だけのクリップは 0 と表示されることがあると注意しています。開始と終了を選ぶ前にプレビューを確認してください。
EasyCoexistence で実現する

即時でも、最大 90 日先までの予約時刻でも可能です。動画は音楽をファイルにミックスした状態で配信されます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

API で TikTok の投稿に好きな曲を追加できますか?

Commercial Music Library の楽曲を ID で指定できます。動画ファイルにすでにミックスされている音楽は、そのファイルと一緒に配信されるため、使用する権利を持つ音楽にしてください。

TikTok の API は、追加した音楽の音量をいくつに設定しますか?

既定では 0 です。music_sound_volume と video_original_sound_volume は 0 から 100 までの範囲で、API 経由では両方とも既定値が 0 です。TikTok アプリでは 50 から始まるため、楽曲を追加する動画ごとに設定してください。

投稿の音楽は、後で広告に使われる場合も問題になりますか?

はい。TikTok が確認します。/identity/music/authorization/ は、広告の配信地域と掲載期間について、投稿の音楽が完全に許諾されているか、許諾が不足しているか、楽曲 ID がないかを報告します。

TikTok の Commercial Music Library には何曲ありますか?

TikTok のビジネスヘルプセンターによると 100 万曲で、すべて商用利用に事前許諾されています。/discovery/cml/trending_list/ は一度に最大 100 件の人気楽曲を返します。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日