API کے ذریعے ویڈیو کو TikTok کریئیٹر کے ڈرافٹس میں بھیجنا
TikTok کے APIs ویڈیو کو اپ لوڈ فلو کے ذریعے کریئیٹر کے ڈرافٹس میں بھیجتے ہیں: Content Posting API کا اینڈ پوائنٹ /v2/post/publish/inbox/video/init/ اسے video.upload اسکوپ کے تحت اپ لوڈ کرتا ہے، اور TikTok کریئیٹر کو ان باکس نوٹیفکیشن بھیجتا ہے تاکہ وہ ایپ میں اسے ایڈٹ کرکے پوسٹ کرے۔ API for Business یہی کام /business/video/publish/ پر upload_to_draft سے کرتا ہے، اور photo posts کے لیے is_draft کے ذریعے۔
easyCoexistence، Claude، ChatGPT یا اپنے پلیٹ فارم سے publish_tiktok_post کے ذریعے TikTok ویڈیوز اور فوٹو پوسٹس فوراً یا 90 دن تک آگے کی کسی تاریخ اور وقت پر شائع کرتا ہے، اور ہر قطار میں لگی پوسٹ جانے تک Posts اسکرین پر دکھائی دیتی ہے۔
TikTok اس اسکوپ کو اس طرح بیان کرتا ہے: کریئیٹر کے اکاؤنٹ میں مواد ڈرافٹ کے طور پر شیئر کرنا تاکہ اسے TikTok میں مزید ایڈٹ اور پوسٹ کیا جا سکے۔
Content Posting API کسی بھی 24 گھنٹے کی مدت میں زیادہ سے زیادہ زیرِ التواء شیئرز کی اجازت دیتا ہے، یہ حد TikTok نے اسپام کم کرنے کے لیے لگائی ہے۔
اسٹیٹس /business/publish/status/ اس وقت بتاتا ہے جب ڈرافٹ اپ لوڈ ہو جائے اور TikTok نے کریئیٹر کے ان باکس کو مطلع کر دیا ہو۔
ہر یوزر ایکسیس ٹوکن Content Posting API کے اپ لوڈ اینڈ پوائنٹ پر کتنی درخواستیں بھیج سکتا ہے۔
جب /business/video/publish/ پر upload_to_draft true ہو تو باقی post_info فیلڈز کے ساتھ کیا ہوتا ہے۔
ڈرافٹ اور براہِ راست پوسٹ میں کیا فرق ہے؟
فرق اس میں ہے کہ Post بٹن کون دباتا ہے۔ براہِ راست پوسٹ TikTok کی پروسیسنگ کے بعد فوراً لائیو ہو جاتی ہے؛ ڈرافٹ کریئیٹر کے TikTok ان باکس میں جاتا ہے، اور تب ہی شائع ہوتا ہے جب کریئیٹر اسے کھول کر اپنی مرضی سے ایڈٹ کرے اور پوسٹ کرے۔ یہ فرق TikTok کے دونوں پوسٹنگ APIs میں یوں چلتا ہے:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Content Posting API ڈرافٹ کیسے اپ لوڈ کرتا ہے؟
ایک POST درخواست /v2/post/publish/inbox/video/init/ پر جاتی ہے، ساتھ میں video.upload والا ایکسیس ٹوکن اور source_info آبجیکٹ۔ PULL_FROM_URL میں TikTok اس ڈومین یا URL پری فِکس سے ویڈیو لاتا ہے جسے ایپ نے تصدیق شدہ کیا ہو؛ FILE_UPLOAD upload_url واپس کرتا ہے، جس پر فائل PUT درخواستوں کے ذریعے حصوں میں بھیجی جاتی ہے۔ واپس آنے والا publish_id /v2/post/publish/status/fetch/ کو جاتا ہے، تصاویر کے لیے /v2/post/publish/content/init/ کا استعمال ہوتا ہے جس میں post_mode کو MEDIA_UPLOAD پر رکھا جاتا ہے، اور TikTok ایپس سے کہتا ہے کہ وہ یوزرز کو بتائیں کہ ایڈیٹنگ جاری رکھنے کے لیے ان باکس نوٹیفکیشن کھولیں:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Content Posting API ڈرافٹس پر کون سی حدیں لاگو ہوتی ہیں؟
TikTok انہیں اپنے اپ لوڈ ریفرنس میں دستاویزی کرتا ہے، ہر ایک init کال کے جواب میں واپس آتی ہے جب وہ لاگو ہو:
- زیرِ التواء ڈرافٹس: 24 گھنٹے کی مدت میں زیادہ سے زیادہ 5 زیرِ التواء شیئرز؛ اس کے بعد
spam_risk_too_many_pending_shareکے ساتھ HTTP 403۔ - درخواستیں: فی یوزر ایکسیس ٹوکن 6 فی منٹ، اس کے بعد
rate_limit_exceededکے ساتھ HTTP 429۔ - اسکوپ: وہ ٹوکن جس کے پاس video.upload نہ ہو، اسے
scope_not_authorizedکے ساتھ HTTP 401 ملتا ہے۔ - میڈیا: ایسی ڈومین یا پری فِکس سے
PULL_FROM_URLجسے ایپ نے تصدیق شدہ نہیں کیا،url_ownership_unverifiedکے ساتھ HTTP 403 دیتا ہے۔
API for Business ڈرافٹ کیسے اپ لوڈ کرتا ہے؟
اس کے پبلشنگ اینڈ پوائنٹس اور post_info میں ایک اضافی فیلڈ کے ذریعے۔ /business/video/publish/ پر upload_to_draft کو true پر رکھنے سے ویڈیو ڈرافٹ کے طور پر بھیجی جاتی ہے، اور TikTok post_info کے باقی فیلڈز نظرانداز کر دیتا ہے؛ /business/photo/publish/ پر is_draft صرف عنوان اور کیپشن رکھتا ہے۔ دونوں کو اکاؤنٹ کے ٹوکن پر video.upload چاہیے، جسے /tt_user/token_info/get/ دکھاتا ہے، اور اگر وہ نہ ہو تو مالک ایپ کو دوبارہ اجازت دے کر ڈرافٹ اپ لوڈنگ کی منظوری دیتا ہے۔ میڈیا اب بھی تصدیق شدہ URL پر ہوتا ہے، اسٹیٹس SEND_TO_USER_INBOX پڑھا جاتا ہے، اور کریئیٹر ان باکس نوٹیفکیشن کے ذریعے ڈرافٹ تک پہنچتا ہے:
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/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'کریئیٹر ڈرافٹ کے ساتھ کیا کرتا ہے؟
TikTok میں اسے مکمل کرتا ہے۔ ان باکس نوٹیفکیشن اپ لوڈ شدہ ویڈیو یا تصاویر کو TikTok کے ایڈیٹر میں کھولتا ہے، جہاں کریئیٹر انہیں دیکھتا اور ایڈٹ کرتا ہے اور پھر پوسٹ کرتا ہے۔ Content Posting API پر، جب کریئیٹر ڈرافٹ سے پوسٹ کرتا ہے تو اسٹیٹس SEND_TO_USER_INBOX سے PUBLISH_COMPLETE پر چلا جاتا ہے، اور TikTok نوٹ کرتا ہے کہ ایک ڈرافٹ ایک سے زیادہ پوسٹس بھی بنا سکتا ہے۔
کیا easyCoexistence ڈرافٹس بھیجتا ہے؟
نہیں: publish_tiktok_post شائع کرتا ہے۔ یہ /business/video/publish/ یا /business/photo/publish/ کو بغیر upload_to_draft یا is_draft کے کال کرتا ہے، اس لیے TikTok کی پروسیسنگ کے بعد پوسٹ فوراً لائیو ہو جاتی ہے۔ پوسٹ کو نظرثانی کے لیے روکنا ہو تو اسے scheduled_at کے ساتھ شیڈول کریں، جو 1 منٹ سے 90 دن آگے تک ہو سکتا ہے: وہ Posts اسکرین پر Coming up کے تحت انتظار کرتی ہے، update_scheduled_post اس کا وقت، کیپشن یا فوٹو پوسٹ کا عنوان بدلتا ہے، اور cancel_scheduled_post اسے جانے سے پہلے روک دیتا ہے۔
عام غلطیاں
- ڈرافٹ بھیجنے کے لیے video.publish مانگنا غلط ہے؛ ڈرافٹس کو video.upload درکار ہے، وہ اسکوپ جسے TikTok مواد کو ڈرافٹ کے طور پر شیئر کرنا بیان کرتا ہے۔
- API for Business پر ویڈیو ڈرافٹ کے لیے کیپشن سیٹ کرنا، جبکہ upload_to_draft true ہو؛ TikTok باقی post_info نظرانداز کر دیتا ہے۔
- کریئیٹرز کے ڈرافٹس پوسٹ کرنے سے زیادہ تیزی سے ڈرافٹ اپ لوڈ کرنا۔ Content Posting API 24 گھنٹوں میں 5 زیرِ التواء شیئرز پر رک جاتا ہے، spam_risk_too_many_pending_share کے ساتھ۔
- یوزرز کو ان باکس تک رہنمائی نہ دینا۔ TikTok ایپس سے کہتا ہے کہ انہیں بتائیں کہ پوسٹ مکمل کرنے کے لیے ان باکس نوٹیفکیشن کھولیں۔
فی کنکشن فی مہینہ US$ 9 سے شروع ہو کر US$ 0.75 تک، کنکشن بڑھانے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن کا فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
کیا TikTok API ویڈیو کو ڈرافٹ کے طور پر محفوظ کر سکتا ہے؟
ہاں۔ اپ لوڈ فلو ویڈیو کو کریئیٹر کے TikTok ان باکس میں ڈالتا ہے، جہاں کریئیٹر اسے ایڈٹ کرکے پوسٹ کرتا ہے؛ ٹوکن کو video.upload اسکوپ درکار ہے۔
API کے ذریعے بھیجا گیا ڈرافٹ کہاں ظاہر ہوتا ہے؟
TikTok ایپ میں، ایک ان باکس نوٹیفکیشن کے پیچھے، جو ویڈیو کو TikTok کے ایڈیٹر میں کھولتا ہے تاکہ کریئیٹر اسے مکمل کرے۔
کیا TikTok ڈرافٹ میرا کیپشن رکھ سکتا ہے؟
API for Business پر فوٹو ڈرافٹ اپنا عنوان اور کیپشن رکھتا ہے، جبکہ ویڈیو ڈرافٹ post_info کے باقی فیلڈز گرا دیتا ہے۔
کیا ایک TikTok ڈرافٹ ایک سے زیادہ پوسٹس بن سکتا ہے؟
ہاں۔ TikTok نوٹ کرتا ہے کہ ایک ڈرافٹ ایک سے زیادہ پوسٹس بنا سکتا ہے، اور Content Posting API پر اسٹیٹس PUBLISH_COMPLETE ہو جاتا ہے جب کریئیٹر اس سے پوسٹ کرتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ