Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

API ile TikTok paylaşımlarına müzik ekleme

TikTok'un İşletmeler için API'si, Commercial Music Library'den müzik ekler: post_info.music_sound_info, videolarda ve fotoğraf paylaşımlarında bir parçanın music_sound_id değerini alır; videolarda ayrıca parçanın ses düzeyini, milisaniye cinsinden başlangıcını ve bitişini ve videonun kendi sesinin ses düzeyini de alır. Fotoğraf paylaşımları önerilen müzik için auto_add_music de alabilir. Parça kimlikleri GET /discovery/cml/trending_list/ uç noktasından gelir.

easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan publish_tiktok_post ile TikTok videolarını ve fotoğraf paylaşımlarını yayınlar; hemen ya da en fazla 90 gün sonrasına planlanmış bir zamanda.

100

/discovery/cml/trending_list/ uç noktasının döndürdüğü en popüler parçalar; hepsi organik içerik ve reklam oluşturma için önceden onaylanmış.

0 to 100

music_sound_volume ve video_original_sound_volume aralığı; API üzerinden ikisi de varsayılan olarak 0'dır, TikTok uygulaması ise 50'den başlar.

1 million

TikTok'un Commercial Music Library'sindeki şarkılar: işletmelerin TikTok'ta ticari faaliyetler için kullandığı, önceden onaylanmış küresel kütüphane.

TikTok only

TikTok'un reklam müzik listesindeki müziklerle hazırlanmış kreatiflerin yayınlanabileceği yerler; hak sahipleri ayrıca izin vermedikçe.

DIRECT_POST

Content Posting API'nin fotoğraf uç noktasının auto_add_music uyguladığı tek post_mode, developers.tiktok.com'da.

TikTok'un yayın uç noktaları hangi müzik alanlarını alır?

Her iki uç nokta da müziği post_info içinde, music_sound_info altında taşır ve bir parçayı Commercial Music Library kimliğiyle belirtir. Bunun ötesinde farklılaşırlar: video uç noktası karıştırma denetimleri ekler, fotoğraf uç noktası ise müziği TikTok'un seçmesini sağlayan bir anahtar ekler. TikTok'un referanslarında listelendiği haliyle yan yana:

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

Bir parçayı videoya nasıl eklersiniz?

POST /business/video/publish/ isteğinde post_info içine music_sound_info gönderin. Nesne bulunduğunda music_sound_id ve music_sound_volume zorunludur. music_sound_start ve music_sound_end, parçanın milisaniye cinsinden hangi bölümünün kullanılacağını seçer; varsayılan olarak parçanın başından videonun tam uzunluğuna kadar gider, bu yüzden 2 saniyelik bir video parçanın ilk 2.000 milisaniyesini alır. Videonun kendi sesi önemliyse video_original_sound_volume değerini de belirleyin; varsayılanı 0'dır:

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
      }
    }
  }'

Parça kimlikleri nereden gelir?

GET /discovery/cml/trending_list/ uç noktasından gelir; bu, bir TikTok hesabının erişim token'ını ve business_id'sini alan bir Discovery API uç noktasıdır; Discovery hashtag uç noktaları ise reklamverenin token'ını alır. TikTok'un referansı bunu Creative Management'ın Discovery izni altında listeler. En fazla 100 popüler parça döndürür; her birinin adı, sanatçısı, süresi, sırası, türleri, süresi dolmayan bir preview_url'si ve en fazla 30 günlük trending_history'si vardır. full_duration_song_clip ve trending_song_clip her biri, TikTok'un music_sound_id için kullandığı adla song_clip_id tutar:

  • genre: varsayılan olarak ALL; ya da POP, LATIN, LO-FI veya SERTANEJO gibi 100'den fazla değerden biri.
  • country_code: varsayılan olarak US. date_range: 1DAY, varsayılan olarak 7DAY, 30DAY veya 90DAY.
  • /discovery/cml/video_list/: bir parçayı kullanan en popüler 20 trend video; parça commercial_music_id, ülke ise country_code ile belirtilir.
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'

Fotoğraf paylaşımları müziği nasıl alır?

POST /business/photo/publish/ üzerinden iki yolla. auto_add_music değerinin true olarak ayarlanması, TikTok'un önerilen müziği eklemesini sağlar; sahibi bunu daha sonra TikTok uygulamasında değiştirebilir. music_sound_info.music_sound_id ise belirli bir kütüphane parçasını adlandırır; fotoğraflarda ses düzeyi, başlangıç ve bitiş alanı yoktur. developers.tiktok.com'da Content Posting API'nin fotoğraf uç noktasının kendi auto_add_music alanı vardır; bu yalnızca post_mode DIRECT_POST olduğunda uygulanır, doğrudan paylaşım video uç noktası ise belgelenmiş bir müzik alanına sahip değildir.

Commercial Music Library işletme hesapları için ne anlama gelir?

Kullanabilecekleri müziktir. TikTok'un Business Help Center'ı kütüphaneyi, ticari kullanım için önceden onaylanmış 1 milyon şarkılık küresel bir koleksiyon olarak tanımlar; işletmelerin genel müzik kütüphanesini ticari amaçla kullanamayacağını söyler ve onları organik içerik, düetler, tepkiler ve dikişler dahil olmak üzere video reklamlar ve markalı içerik için Commercial Music Library'ye yönlendirir. Business Account'ta uygulamadaki “Add Sound” yalnızca kütüphane seslerini gösterir; API de aynı sınırı çizer, çünkü music_sound_id bir kütüphane kimliği alır.

API müzikle neler yapamaz?

Bazı şeyler TikTok'un referanslarının anlattığı gibi alanlarının dışında kalır:

  • TikTok'un genel kütüphanesinden bir sesi adlandırmak: music_sound_id, Commercial Music Library kimliği alır.
  • Kütüphaneyi başlığa göre aramak: /discovery/cml/trending_list/ popüler parçaları türe, ülkeye ve döneme göre filtreler.
  • Bir parçayı taslakta tutmak: upload_to_draft, TikTok'un post_info'nun geri kalanını yok saymasına neden olur; is_draft ise yalnızca başlığı ve açıklamayı tutar.
  • Organik bir paylaşımda kendi parçanızı kullanmak: /file/music/upload/ reklam kreatifleri için advertiser_id altında müzik ekler; TikTok'un bu uyarısı telif sorumluluğunu yükleyene bırakır.

Geçici çözümler nelerdir?

Üç tane var; her biri TikTok'un referanslarında belgelenen bir şeye dayanır, bir de tartılması gereken bir risk:

  • Müziği dosyaya karıştırın. TikTok'un kısıtları videoyu ses-görüntü içeriği olarak tanımlar; yani karıştırılmış bir ses parçası onunla birlikte gider. Hakları sizde olan sesleri kullanın.
  • Taslak gönderin. upload_to_draft ya da is_draft ve video.upload kapsamıyla paylaşım, yaratıcının TikTok gelen kutusuna düşer; uygulamada düzenlenip paylaşılır.
  • Fotoğraf paylaşımlarında TikTok'un seçmesine izin verin. auto_add_music önerilen müziği ekler; sahibi bunu daha sonra TikTok uygulamasında değiştirebilir.
  • Karışık sesle ilgili risk: TikTok'un paylaşım listesi referansı, müzik telif hakkı ihlallerini bir paylaşımın filtrelenmesinin olası nedenleri arasında sayar.

Bir sesin izlenme getirip getirmediğini nasıl görürsünüz?

impression_sources aracılığıyla; bu, /business/video/list/ alanıdır ve bir paylaşımın izleyicilerinin onu nerede bulduğunu sıralar. Değerlerinden biri Sound'dur; ses sayfalarından gelen izlenmeler için. video.insights kapsamını gerektirir ve diğer sayılar gibi 24 ila 48 saat geç gelir. easyCoexistence üzerinden, metrics içinde impression_sources adı geçtiğinde get_social_insights, hesabın son 20 paylaşımından biri için bunu döndürür; object_id olarak paylaşımın item_id değeri kullanılır.

easyCoexistence müzikle ne yapar?

Dosyanızda zaten bulunan sesi yayınlar. Hemen ya da scheduled_at ile publish_tiktok_post, başlığı, fotoğraf paylaşımının başlığını ve yorum ayarını gönderir; music_sound_info ya da auto_add_music yoktur. Böylece video kendi sesini korur, fotoğraf paylaşımı ise müziksiz çıkar. Kendi kodunuz, music_sound_info ve get_social_credentials'tan aldığı token ile business/video/publish/ adresine POST gönderebilir; ancak bu gövde, video_url dahil olduğu gibi TikTok'a iletilir ve TikTok medyayı yalnızca uygulama için doğrulanmış alan adlarından ya da URL önekinden çeker. /discovery/ yolları bir reklamverenin token'ını aldığından parça listesi hesap token'ının erişiminin dışındadır.

Yaygın hatalar

  • Bir parça eklerken video_original_sound_volume değerini atlamak. API üzerinden varsayılan 0'dır; TikTok uygulaması ise iki sesi de 50'den başlatır. Videonun kendi sesi önemliyse bunu her zaman belirleyin.
  • Bir parçanın adını ya da preview_url'sini music_sound_id olarak göndermek. TikTok'un parça referansı, full_duration_song_clip ya da trending_song_clip içindeki song_clip_id'yi geçilecek değer olarak adlandırır.
  • /discovery/cml/trending_list/ uç noktasını bir reklamveren token'ıyla çağırmak. Parça uç noktaları, Accounts API'de olduğu gibi bir TikTok hesabının token'ını ve business_id'yi alır.
  • Süresi 0 olan bir parçayı bozuk saymak. TikTok, daha uzun bir parçanın yalnızca klibi olan bir parçanın 0 gösterebileceğini belirtir; başlangıç ve bitişi seçmeden önce önizlemesini kontrol edin.
Bunu EasyCoexistence'la yapmak

Video, sesi dosyasına karıştırılmış olarak çıkar. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar düşer, bağlantı ekledikçe; ilk 3 gün ücretsizdir.

Sık sorulan sorular

API üzerinden TikTok paylaşımına istediğim şarkıyı ekleyebilir miyim?

Commercial Music Library'deki şarkıları kimlikleriyle ekleyebilirsiniz. Video dosyasına zaten karışmış müzik, dosyayla birlikte gider; bu yüzden kullanma hakkına sahip olduğunuz müzik olmalıdır.

TikTok'un API'si eklenen müzik için hangi ses düzeyini ayarlar?

Varsayılan olarak 0'dır. music_sound_volume ve video_original_sound_volume 0 ile 100 arasında çalışır ve API üzerinden ikisi de varsayılan olarak 0'dır; TikTok uygulaması ise 50'den başlar. Bu yüzden bir parça kullanan her videoda bunları ayrı ayrı belirleyin.

Bir paylaşımın müziği, paylaşım sonradan bir reklamda kullanılırsa önemli mi?

Evet, TikTok bunu denetler: /identity/music/authorization/, reklamın yerleri ve yayın tarihleri için paylaşımın müziğinin tamamen yetkili mi, yetkisi eksik mi yoksa şarkı kimliği olmadan mı olduğunu bildirir.

TikTok'un Commercial Music Library'sinde kaç şarkı var?

TikTok'un Business Help Center'ına göre 1 milyon; hepsi ticari kullanım için önceden onaylanmıştır. /discovery/cml/trending_list/ bir seferde en fazla 100 popüler şarkı döndürür.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi