API کے ذریعے TikTok پوسٹس میں میوزک شامل کرنا
TikTok کا API for Business اپنی Commercial Music Library سے میوزک شامل کرتا ہے: ویڈیو اور فوٹو پوسٹس پر post_info.music_sound_info میں ٹریک کی music_sound_id دی جاتی ہے، اور ویڈیو پر ٹریک کا والیوم، اس کا آغاز اور اختتام ملی سیکنڈ میں، اور ویڈیو کی اپنی آواز کا والیوم بھی۔ فوٹو پوسٹس تجویز کردہ میوزک کے لیے auto_add_music بھی لے سکتی ہیں۔ ٹریک IDs GET /discovery/cml/trending_list/ سے آتی ہیں۔
easyCoexistence، Claude، ChatGPT یا اپنے کوڈ سے publish_tiktok_post کے ذریعے TikTok ویڈیوز اور فوٹو پوسٹس شائع کرتا ہے، ابھی یا 90 دن تک پہلے سے طے شدہ وقت پر، اور ویڈیو اپنی فائل میں مکس ساؤنڈ ٹریک کے ساتھ جاتی ہے۔
/discovery/cml/trending_list/ جو مقبول ترین ٹریک واپس کرتا ہے، یہ سب نامیاتی مواد اور اشتہارات کے لیے پہلے سے کلیئر شدہ ہیں۔
music_sound_volume اور video_original_sound_volume کی رینج؛ API کے ذریعے دونوں ڈیفالٹ 0 ہوتے ہیں، جب کہ TikTok ایپ 50 سے شروع ہوتی ہے۔
TikTok کی Commercial Music Library کے گانے، وہ پہلے سے کلیئر شدہ عالمی لائبریری جسے کاروبار TikTok پر تجارتی سرگرمیوں کے لیے استعمال کرتے ہیں۔
وہ جگہیں جہاں TikTok کی اشتہاری میوزک فہرست سے بنائے گئے تخلیقی مواد دکھائے جا سکتے ہیں، جب تک حقوق رکھنے والے الگ اجازت نہ دیں۔
وہ واحد post_mode جس میں Content Posting API کا فوٹو اینڈ پوائنٹ auto_add_music لاگو کرتا ہے، developers.tiktok.com پر۔
TikTok کے پبلش اینڈ پوائنٹس کون سے میوزک فیلڈز لیتے ہیں؟
دونوں اینڈ پوائنٹس میوزک post_info کے اندر music_sound_info میں رکھتے ہیں، اور ٹریک کو اس کے Commercial Music Library ID سے نامزد کرتے ہیں۔ اس کے علاوہ ان میں فرق ہے: ویڈیو اینڈ پوائنٹ میں مکسنگ کنٹرولز شامل ہیں، اور فوٹو اینڈ پوائنٹ میں ایک سوئچ ہے جس سے 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 |
ویڈیو میں ٹریک کیسے شامل کریں؟
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 ہے:
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
}
}
}'ٹریک IDs کہاں سے آتے ہیں؟
GET /discovery/cml/trending_list/ سے، جو Discovery API کا اینڈ پوائنٹ ہے اور TikTok اکاؤنٹ کا ایکسیس ٹوکن اور business_id لیتا ہے، جب کہ Discovery hashtag اینڈ پوائنٹس ایڈورٹائزر کا لیتے ہیں؛ TikTok کا حوالہ اسے Creative Management کی Discovery permission کے تحت درج کرتا ہے۔ یہ 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کے لیے 1DAY، ڈیفالٹ 7DAY، 30DAY یا 90DAY ممکن ہیں۔- /discovery/cml/
video_list/: ایک ٹریک کو اس کےcommercial_music_idاور ایکcountry_codeسے استعمال کرنے والی 20 سب سے زیادہ ٹرینڈنگ ویڈیوز۔
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 ہو، اور اس کے direct-post ویڈیو اینڈ پوائنٹ میں کوئی میوزک فیلڈ درج نہیں۔
Commercial Music Library کاروباری اکاؤنٹس کے لیے کیا معنی رکھتی ہے؟
یہ وہ میوزک ہے جو وہ استعمال کر سکتے ہیں۔ TikTok کا Business Help Center اس لائبریری کو 1 million گانوں کا پہلے سے کلیئر شدہ عالمی مجموعہ بتاتا ہے، کہتا ہے کہ کاروبار عمومی میوزک لائبریری کو تجارتی استعمال کے لیے استعمال نہیں کر سکتے، اور انہیں Commercial Music Library کی طرف بھیجتا ہے، جو نامیاتی مواد، ڈوئٹس، ری ایکٹس اور اسٹچز سمیت، ویڈیو اشتہارات اور برانڈڈ مواد کے لیے ہے۔ Business اکاؤنٹ پر ایپ میں Add Sound صرف لائبریری کی آوازیں دکھاتا ہے، اور API بھی یہی حد کھینچتا ہے، کیونکہ music_sound_id لائبریری ID لیتا ہے۔
API میوزک کے ساتھ کیا نہیں کر سکتا؟
کچھ چیزیں اس کے فیلڈز سے باہر ہیں، جیسا کہ TikTok کے حوالہ جات انہیں بیان کرتے ہیں:
- TikTok کی عمومی لائبریری سے کوئی ساؤنڈ نامزد کرنا:
music_sound_idCommercial Music Library ID لیتا ہے۔ - عنوان سے لائبریری تلاش کرنا: /discovery/cml/
trending_list/ مقبول ٹریک کو genre، ملک اور مدت کے لحاظ سے فلٹر کرتا ہے۔ - کسی ڈرافٹ پر میوزک رکھنا:
upload_to_draftباقی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 تازہ ترین پوسٹس میں سے ایک کے لیے اسے واپس کرتا ہے، جب metrics میں impression_sources نامزد ہو، اور پوسٹ کا item_id object_id ہو۔
easyCoexistence میوزک کے ساتھ کیا کرتا ہے؟
یہ آپ کی فائل میں پہلے سے موجود آواز شائع کرتا ہے۔ publish_tiktok_post، ابھی یا scheduled_at کے ساتھ، کیپشن، فوٹو پوسٹ کا عنوان اور کمنٹ سیٹنگ بھیجتا ہے، بغیر music_sound_info اور بغیر auto_add_music کے، تاکہ ویڈیو اپنا ساؤنڈ ٹریک رکھے اور فوٹو پوسٹ بغیر میوزک کے جائے۔ آپ کا اپنا کوڈ get_social_credentials کے ٹوکن کے ساتھ business/video/publish/ پر music_sound_info کے ساتھ POST کر سکتا ہے، لیکن وہ باڈی جیسی لکھی گئی ہے ویسے ہی 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 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا میں 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/ اشتہار کے مقامات اور چلنے کی تاریخوں کے لیے بتاتا ہے کہ پوسٹ کا میوزک مکمل طور پر مجاز ہے، اجازت غائب ہے، یا song ID کے بغیر ہے۔
TikTok کی Commercial Music Library میں کتنے گانے ہیں؟
1 million، TikTok کے Business Help Center کے مطابق، جو سب تجارتی استعمال کے لیے پہلے سے کلیئر شدہ ہیں۔ /discovery/cml/trending_list/ ایک بار میں 100 تک مقبول گانے واپس کرتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ