הוספת מוזיקה לפוסטים ב-TikTok דרך ה-API
ה-API for Business של TikTok מוסיף מוזיקה מהספרייה המסחרית Commercial Music Library: post_info.music_sound_info מקבל את music_sound_id של שיר בפוסטים של סרטונים ותמונות, ובסרטונים גם את העוצמה של השיר, את נקודות ההתחלה והסיום שלו באלפיות השנייה ואת העוצמה של השמע המקורי של הסרטון. בפוסטי תמונות אפשר גם להפעיל auto_add_music למוזיקה מומלצת. מזהי השירים מגיעים מנקודת הקצה /discovery/cml/trending_list/, שמחזירה את השירים הפופולריים.
easyCoexistence מפרסמת סרטונים ופוסטים של תמונות ב-TikTok בעזרת publish_tiktok_post, מ-Claude, מ-ChatGPT או מהקוד שלכם, עכשיו או בזמן שנקבע עד 90 ימים קדימה, וסרטון יוצא עם הפסקול שמעורבב בקובץ שלו.
השירים הפופולריים ביותר שמחזירה /discovery/cml/trending_list/, כולם מאושרים מראש ליצירת תוכן אורגני וליצירת מודעות.
טווח הערכים של music_sound_volume וגם video_original_sound_volume. דרך ה-API ברירת המחדל של שניהם היא 0, ואילו באפליקציה של TikTok שניהם מתחילים מ-50 בכל שדה.
שירים ב-Commercial Music Library של TikTok, הספרייה הגלובלית המאושרת מראש שעסקים משתמשים בה לפעילות מסחרית בפלטפורמה.
המקומות שבהם עשויים להופיע מודעות עם מוזיקה מרשימת המוזיקה למודעות של TikTok, אלא אם בעלי הזכויות נותנים הרשאה נפרדת.
מצב post_mode היחיד שבו נקודת הקצה לתמונות של Content Posting API מפעילה את auto_add_music הוא DIRECT_POST, לפי התיעוד באתר המפתחים.
אילו שדות מוזיקה נקודות הקצה לפרסום של TikTok מקבלות?
שתי נקודות הקצה מכילות מוזיקה בתוך post_info, תחת music_sound_info, ומציינות שיר לפי המזהה שלו בספרייה המסחרית. מעבר לכך הן שונות: נקודת הקצה לסרטונים מוסיפה בקרות מיקס, ונקודת הקצה לתמונות מוסיפה מתג שמאפשר ל-TikTok לבחור את המוזיקה. כך מפרטים את ההבדלים במסמכי העזר של TikTok, זה לצד זה:
| Video post | Photo post | |
|---|---|---|
| The track | music_sound_info.music_sound_id | music_sound_info.music_sound_id |
| Track volume | music_sound_volume, 0 to 100, required with a track | No field |
| Part of the track | music_sound_start and music_sound_end, in milliseconds | No field |
| The video's own sound | video_original_sound_volume, 0 to 100 | Not applicable |
| Recommended music | No field | auto_add_music, false by default |
| As a draft | upload_to_draft drops the rest of post_info | is_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 שניות לוקח את 2,000 האלפיות הראשונות של השיר. מגדירים גם את video_original_sound_volume בכל מקרה שבו השמע המקורי של הסרטון חשוב, כי ברירת המחדל שלו היא 0, כלומר השמע המקורי יושתק אם לא מגדירים אותו.
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
}
}
}'מאיפה מגיעים מזהי השירים?
מנקודת הקצה /discovery/cml/trending_list/, שמקבלת אסימון גישה של חשבון TikTok ואת business_id, בעוד שנקודות הקצה של ההאשטגים ב-Discovery מקבלות את זה של מפרסם. מסמך העזר של TikTok משייך אותה להרשאת Discovery בתוך Creative Management. היא מחזירה עד 100 שירים פופולריים, שלכל אחד מהם יש שם, אמן, משך, דירוג, ז'אנרים, preview_url שאינו פג תוקף, ועד 30 ימים של trending_history, שהיא היסטוריית הטרנד. כל אחד משני השדות full_duration_song_clip וגם trending_song_clip מכיל song_clip_id, והערך הזה הוא מה שנכנס לשדה music_sound_id בפועל:
- genre: ברירת המחדל היא ALL, או אחד מיותר מ-100 ערכים כגון POP, LATIN, LO-FI או SERTANEJO, ועוד רבים.
country_code: US כברירת מחדל.date_range: 1DAY, 7DAY כברירת מחדל, 30DAY או 90DAY, לפי טווח התאריכים.- /discovery/cml/
video_list/: 20 הסרטונים הפופולריים ביותר שמשתמשים בשיר, לפיcommercial_music_idוקוד מדינה.
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 מוסיף מוזיקה מומלצת, והבעלים יכול לשנות אותה אחר כך באפליקציה. בדרך השנייה, music_sound_info.music_sound_id מציין שיר ספציפי מהספרייה, ואין לתמונות שדות של עוצמה, התחלה או סיום. ב-developers.tiktok.com, לנקודת הקצה לתמונות של Content Posting API יש auto_add_music משלה, שחל רק כאשר post_mode הוא DIRECT_POST, ולנקודת הקצה של סרטון בפרסום ישיר אין שדה מוזיקה מתועד.
מה משמעות הספרייה המסחרית לחשבונות עסקיים?
זו המוזיקה שמותר להם להשתמש בה. מרכז העזרה לעסקים של TikTok מתאר את הספרייה כאוסף גלובלי מאושר מראש של מיליון שירים, אומר שעסקים לא יכולים להשתמש בספריית המוזיקה הכללית לשימוש מסחרי, ומפנה אותם לספרייה המסחרית לתוכן אורגני, כולל דואטים, reacts ו-stitches, סרטוני מודעות ותוכן ממותג. בחשבון עסקי, Add Sound באפליקציה מציג רק צלילים מהספרייה, וה-API מציב את אותו גבול, כי music_sound_id מקבל מזהה מהספרייה.
מה ה-API לא יכול לעשות עם מוזיקה?
כמה דברים נמצאים מחוץ לשדות שלו, כפי שמתארים מסמכי העזר של 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 לפוסטים מציינת הפרות זכויות יוצרים במוזיקה, בין הסיבות הסבירות לכך שפוסט יסונן.
איך רואים אם שיר הביא צפיות?
דרך impression_sources, שדה של נקודת הקצה /business/video/list/ שמדרג מאיפה הגיעו הצופים של פוסט; אחד הערכים שלו הוא Sound, שמייצג צפיות שהגיעו מדפי צלילים. השדה דורש את ההרשאה video.insights, וכמו שאר הספירות הוא מגיע באיחור של 24 עד 48 שעות. דרך easyCoexistence, כאשר impression_sources מופיע בתוך metrics ומזהה הפוסט (item_id) משמש בתור object_id, get_social_insights מחזיר את הערך לאחד מ-20 הפוסטים האחרונים בחשבון.
מה easyCoexistence עושה עם מוזיקה?
הוא מפרסם את הצליל שכבר נמצא בקובץ שלכם. publish_tiktok_post, עכשיו או עם scheduled_at, שולח את הכיתוב, את כותרת פוסט התמונה ואת הגדרת התגובות, בלי music_sound_info ובלי auto_add_music, כך שסרטון שומר על הפסקול שלו ופוסט תמונה יוצא ללא מוזיקה. הקוד שלכם יכול לשלוח POST לנקודת הקצה business/video/publish/ עם music_sound_info ועם האסימון מ-get_social_credentials, אבל הגוף נשלח ל-TikTok כפי שנכתב, כולל video_url, ו-TikTok מביא מדיה רק מדומיינים או מקידומות של כתובות URL שאומתו לאפליקציה. נקודות הקצה של /discovery/ מקבלות אסימון של מפרסם, ולכן רשימת השירים אינה בהישג ידו של האסימון של החשבון.
טעויות נפוצות
- להשמיט את video_original_sound_volume בעת הוספת שיר. דרך ה-API ברירת המחדל שלו היא 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, לכן בדקו את התצוגה המקדימה שלו לפני שבוחרים את ערכי ההתחלה והסיום.
החל מ-US$ 9 עד US$ 0.75 לחיבור בחודש, כשהמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
אפשר להוסיף כל שיר לפוסט ב-TikTok דרך ה-API?
שירים מהספרייה המסחרית, לפי מזהה. מוזיקה שכבר מעורבבת בקובץ הסרטון יוצאת איתו, ולכן כדאי שתהיה מוזיקה שיש לכם זכות להשתמש בה.
איזו עוצמה ה-API של TikTok קובע למוזיקה שנוספה?
ברירת המחדל דרך ה-API היא 0. טווח הערכים של music_sound_volume וגם video_original_sound_volume הוא 0 עד 100, ואילו באפליקציה של TikTok שניהם מתחילים מ-50 בכל שדה. הגדירו אותם בכל סרטון עם שיר.
האם למוזיקה של הפוסט יש משמעות אם הפוסט ישמש מאוחר יותר במודעה?
TikTok בודק זאת: /identity/music/authorization/ מדווח, לפי המיקומים ותאריכי ההצגה של המודעה, אם המוזיקה של הפוסט מאושרת במלואה, חסרה לה הרשאה או שאין לה מזהה שיר.
כמה שירים יש בספרייה המסחרית של TikTok?
1 מיליון שירים, לפי מרכז העזרה לעסקים של TikTok, וכולם מאושרים מראש לשימוש מסחרי. נקודת הקצה /discovery/cml/trending_list/ מחזירה עד 100 שירים פופולריים בכל פעם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-