تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

إضافة الموسيقى إلى منشورات TikTok عبر API

تضيف واجهة TikTok للأعمال الموسيقى من مكتبة الموسيقى التجارية الخاصة بها: يأخذ music_sound_info داخل post_info معرّف music_sound_id الخاص بالمقطع في الفيديوهات ومنشورات الصور، وفي الفيديوهات أيضًا حجم المقطع وبدايته ونهايته بالميلي ثانية، وحجم الصوت الأصلي للفيديو. ويمكن لمنشورات الصور أن تأخذ أيضًا auto_add_music لاقتراح موسيقى. وتُستخرج معرّفات المقاطع من المسار GET /discovery/cml/trending_list/ الذي يُرجع المقاطع الرائجة.

تنشر easyCoexistence فيديوهات TikTok ومنشورات الصور باستخدام publish_tiktok_post من Claude أو ChatGPT أو من كودك الخاص، فورًا أو في موعد محدد حتى 90 يومًا مقدمًا، ويخرج الفيديو بالموسيقى الممزوجة في ملفه.

100

أشهر المقاطع التي يُرجعها /discovery/cml/trending_list/، وكلها معتمدة مسبقًا للمحتوى العضوي وإنشاء الإعلانات.

0 to 100

نطاق music_sound_volume وvideo_original_sound_volume؛ عبر الواجهة تكون القيمتان 0 افتراضيًا، بينما يبدأ تطبيق TikTok من 50.

1 million

أغانٍ في مكتبة الموسيقى التجارية لدى TikTok، المكتبة العالمية المعتمدة مسبقًا التي تستخدمها الأنشطة التجارية على المنصة.

TikTok only

قد تُعرض الإعلانات المصنوعة بموسيقى من قائمة TikTok الإعلانية في أماكن معيّنة، ما لم يمنح أصحاب الحقوق إذنًا منفصلًا.

DIRECT_POST

في developers.tiktok.com، تطبّق نقطة نهاية الصور في Content Posting API الخاصية auto_add_music فقط عندما تكون قيمة post_mode هي DIRECT_POST، أي النشر المباشر.

ما حقول الموسيقى التي تقبلها نقاط نشر TikTok؟

تحمل نقطتا النهاية الموسيقى داخل post_info، ضمن music_sound_info، وتحددان المقطع بمعرّفه في مكتبة الموسيقى التجارية. وبعد ذلك تختلفان: تضيف نقطة نهاية الفيديو أدوات المزج، وتضيف نقطة نهاية الصور مفتاحًا يتيح لـ 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

كيف تضيف مقطعًا إلى فيديو؟

أرسل music_sound_info داخل post_info في POST /business/video/publish/. وبمجرد وجود الكائن تصبح music_sound_id وmusic_sound_volume مطلوبتين. يحدد music_sound_start وmusic_sound_end الجزء المختار من المقطع بالميلي ثانية، ويمتد افتراضيًا من بداية المقطع إلى المدة الكاملة للفيديو، فيستخدم فيديو مدته ثانيتان أول 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
      }
    }
  }'

من أين تأتي معرّفات المقاطع؟

من GET /discovery/cml/trending_list/، وهي نقطة نهاية في Discovery API تأخذ رمز الوصول الخاص بحساب TikTok ومعرّف business_id، بينما تأخذ نقاط الهاشتاغ في Discovery رمز المعلن. وتصنّفها مراجع TikTok ضمن صلاحية Discovery في Creative Management. ويُرجع حتى 100 مقطع رائج، ولكل مقطع اسمه وفنانه ومدته وترتيبه وأنواعه، وpreview_url لا تنتهي صلاحيته، وحتى 30 يومًا من trending_history. يحمل كلٌّ من full_duration_song_clip وtrending_song_clip الحقل song_clip_id، وهو القيمة التي تسمّيها TikTok music_sound_id:

  • genre: ALL افتراضيًا، أو إحدى أكثر من 100 قيمة مثل POP وLATIN وLO-FI وSERTANEJO
  • country_code: US افتراضيًا. date_range: الافتراضي هو 7DAY، والخيارات الأخرى هي 1DAY و30DAY و90DAY، وهي فترات زمنية بالأيام
  • /discovery/cml/video_list/: أعلى 20 فيديو رائجًا يستخدم المقطع، بحسب commercial_music_id ورمز country_code الخاص بالدولة
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/. تضيف 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، ونقطة نهاية الفيديو للنشر المباشر لا توثّق أي حقل موسيقى.

ماذا تعني مكتبة الموسيقى التجارية لحسابات الأعمال؟

هي الموسيقى التي يحق لهم استخدامها. تصف مراكز مساعدة الأعمال لدى TikTok المكتبة بأنها مجموعة عالمية معتمدة مسبقًا تضم مليون أغنية، وتقول إن الأعمال لا تستطيع استخدام مكتبة الموسيقى العامة للاستخدام التجاري، وتوجّهها إلى مكتبة الموسيقى التجارية للمحتوى العضوي، بما في ذلك الدويتو وreacts وstitches، والفيديوهات الإعلانية والمحتوى المدفوع العلامة التجارية. وفي حساب أعمال، يعرض Add Sound في التطبيق مقاطع المكتبة فقط، وتطبّق الواجهة الفصل نفسه، لأن music_sound_id يقبل معرّف مكتبة فقط.

ما الذي لا تستطيع الواجهة فعله بالموسيقى؟

هناك أمور خارج حقولها، كما تصفها مراجع TikTok:

  • تسمية صوت من المكتبة العامة لـ TikTok: music_sound_id يقبل معرّف مكتبة الموسيقى التجارية فقط
  • البحث في المكتبة بالعنوان: /discovery/cml/trending_list/ يصفّي المقاطع الرائجة حسب النوع والدولة والفترة الزمنية
  • إبقاء الموسيقى على مسودة: upload_to_draft يجعل TikTok يتجاهل بقية post_info، وis_draft يُبقي العنوان والتعليق فقط
  • استخدام مقطع خاص بك في منشور عضوي: /file/music/upload/ يضيف موسيقى لمواد الإعلانات ضمن advertiser_id، وإشعار TikTok هناك يترك مسؤولية حقوق النشر على عاتق من رفع الملف

ما الحلول البديلة؟

ثلاثة، كل منها مبني على ما توثّقه مراجع TikTok، مع خطر واحد يجب وزنه:

  • مزج الموسيقى في الملف. تصف قيود 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، يُرجع get_social_insights هذا الحقل لأحد أحدث 20 منشورًا في الحساب، إذا ذُكر impression_sources في metrics، ويُمرَّر فيه item_id للمنشور بوصفه object_id، أي معرّف المنشور.

ماذا تفعل easyCoexistence بالموسيقى؟

تنشر الصوت الموجود بالفعل في ملفك. يرسل publish_tiktok_post، سواء فورًا أو مع scheduled_at، التعليق وعنوان منشور الصورة وإعداد التعليقات، دون music_sound_info ودون auto_add_music، فيحتفظ الفيديو بموسيقاه الخاصة، وينشر منشور الصورة بلا موسيقى. يمكن للكود الخاص بك أن ينفذ POST إلى business/video/publish/ مع music_sound_info وtoken من get_social_credentials، لكن هذا الجسم يصل إلى TikTok كما هو، بما في ذلك video_url، وتجلب TikTok الوسائط فقط من النطاقات أو بادئات الروابط المتحقَّق منها للتطبيق. ومسارات /discovery/ تأخذ token مُعلِن، لذلك فقائمة المقاطع خارج نطاق token الحساب.

الأخطاء الشائعة

  • ترك video_original_sound_volume عند إضافة مقطع. عبر الواجهة تكون قيمته الافتراضية 0، بينما يبدأ تطبيق TikTok الصوتين من 50، لذا اضبطه كلما كان صوت الفيديو الأصلي مهمًا.
  • تمرير اسم المقطع أو preview_url كقيمة لـ music_sound_id. تسمّي وثيقة مقاطع TikTok الحقل song_clip_id، الموجود في full_duration_song_clip أو trending_song_clip، بوصفه القيمة الواجب تمريرها.
  • استدعاء /discovery/cml/trending_list/ برمز معلن. تأخذ نقاط المقاطع رمز حساب TikTok وbusiness_id، كما تفعل Accounts API.
  • قراءة مدة 0 على أنها مقطع معطوب. تنبه TikTok إلى أن المقطع الذي هو مجرد جزء من عمل أطول قد يظهر بمدة 0، لذا تحقّق من معاينته قبل اختيار البداية والنهاية.
إنجاز ذلك باستخدام EasyCoexistence

US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها أول 3 أيام.

الأسئلة الشائعة

هل يمكنني إضافة أي أغنية إلى منشور TikTok عبر API؟

أغانٍ من مكتبة الموسيقى التجارية بمعرّفها. الموسيقى الممزوجة أصلًا في ملف الفيديو تخرج مع الملف، لذا يجب أن تكون موسيقى تملك حق استخدامها.

ما مستوى الصوت الذي تضبطه واجهة TikTok للموسيقى المضافة؟

0 افتراضيًا. تتراوح music_sound_volume وvideo_original_sound_volume من 0 إلى 100، وكلاهما قيمته الافتراضية 0 عبر الواجهة، بينما يبدأ تطبيق TikTok من 50، لذا اضبطهما في كل فيديو فيه مقطع.

هل تهم موسيقى المنشور إذا استُخدم لاحقًا في إعلان؟

يتحقق TikTok منها، إذ يبيّن /identity/music/authorization/ لمواقع الإعلان وتواريخ تشغيله ما إذا كانت موسيقى المنشور مصرّحًا بها بالكامل، أو بلا تصريح، أو بلا معرّف أغنية.

كم عدد الأغاني في مكتبة الموسيقى التجارية لدى TikTok؟

مليون أغنية بحسب مركز مساعدة الأعمال لدى TikTok، وكلها معتمدة مسبقًا للاستخدام التجاري. يُرجع /discovery/cml/trending_list/ حتى 100 منها رائجة في كل مرة.

تابع القراءة

كيف تنشر فيديو على TikTok عبر واجهة برمجة التطبيقات (API)انشر فيديو على TikTok عبر واجهة TikTok للأعمال، مع نقطة النشر وجسم JSON وshare_id المُعاد وطلب الحالة، بأمثلة curl وPython.منشورات الصور وعروض الشرائح على TikTok عبر API: حتى 35 صورةكيف تنشر واجهة TikTok للأعمال منشورات الصور: من 1 إلى 35 صورة بصيغة JPEG أو WebP حتى 20 ميغابايت لكل صورة، مع عنوان وتعليق وصورة غلاف.ماذا تستطيع واجهة برمجة التطبيقات (API) من TikTok عام 2026، وما الذي يبقى داخل التطبيقما تتيحه TikTok API للأعمال عام 2026: المنشورات والتعليقات والتحليلات وwebhooks، وما يبقى في التطبيق مثل الرسائل المباشرة وتعديل الفيديو.أفضل وقت للنشر على TikTok، من بيانات واجهة برمجة التطبيقات (API) نفسهااعثر على ساعات النشر الأفضل لحساب TikTok في audience_activity، وهي أعداد المتابعين النشطين في كل ساعة، ثم جدولة المنشورات فيها.هاشتاغات TikTok عبر API: الاقتراحات والهاشتاغات الرائجةواجهة الهاشتاغات في TikTok: 10 اقتراحات لكل كلمة بـ 35 لغة، وأعلى 200 هاشتاغ رائج، والرمز الذي تحتاجه كل واحدة، والأوصاف المبنية عليها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في