एपीआई के ज़रिए TikTok क्रिएटर के ड्राफ़्ट में वीडियो भेजना
TikTok के एपीआई वीडियो को क्रिएटर के ड्राफ़्ट में अपलोड फ़्लो से भेजते हैं: Content Posting API का /v2/post/publish/inbox/video/init/ उसे video.upload स्कोप के तहत अपलोड करता है, और TikTok क्रिएटर को इनबॉक्स नोटिफ़िकेशन भेजता है ताकि वे उसे ऐप में एडिट करके पोस्ट कर सकें। API for Business यही काम /business/video/publish/ पर upload_to_draft से करता है, या फ़ोटो पोस्ट पर 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 के बाकी फ़ील्ड्स के साथ क्या होता है।
ड्राफ़्ट और सीधी पोस्ट में क्या अंतर है?
फ़र्क इस बात में है कि पोस्ट कौन दबाता है। सीधी पोस्ट TikTok के प्रोसेस करते ही लाइव हो जाती है; ड्राफ़्ट क्रिएटर के TikTok इनबॉक्स में जाता है, और तभी प्रकाशित होता है जब क्रिएटर उसे खोलकर अपनी मर्ज़ी से एडिट करे और पोस्ट करे। यह अंतर TikTok की दोनों पोस्टिंग एपीआई में दिखता है:
| 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 ड्राफ़्ट कैसे अपलोड करता है?
https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ पर POST अनुरोध से, video.upload वाले यूज़र एक्सेस टोकन और एक source_info ऑब्जेक्ट के साथ। PULL_FROM_URL में TikTok ऐप के सत्यापित किए गए डोमेन या यूआरएल प्रीफ़िक्स से वीडियो खींचता है; FILE_UPLOAD एक upload_url लौटाता है, जिस पर PUT अनुरोधों में फ़ाइल हिस्सों में भेजी जाती है। लौटाया गया publish_id /v2/post/publish/status/fetch/ पर जाता है, फ़ोटो के लिए post_mode को MEDIA_UPLOAD रखकर /v2/post/publish/content/init/ इस्तेमाल होता है, और TikTok ऐप्स से कहता है कि वे यूज़र्स को बताएँ कि 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 लंबित शेयर; इसके बाद HTTP 403 के साथ
spam_risk_too_many_pending_share। - अनुरोध: हर यूज़र एक्सेस टोकन के लिए प्रति मिनट 6 अनुरोध, उसके बाद HTTP 429 के साथ
rate_limit_exceeded। - स्कोप: जिस टोकन में video.upload न हो, उसे HTTP 401 के साथ
scope_not_authorizedमिलता है। - मीडिया: ऐप द्वारा सत्यापित न किए गए डोमेन या प्रीफ़िक्स से
PULL_FROM_URLपर HTTP 403 के साथurl_ownership_unverifiedमिलता है।
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/ सूचीबद्ध करता है, और उसके बिना खाते का मालिक ऐप को फिर से अधिकृत करके ड्राफ़्ट अपलोड की मंज़ूरी देता है। मीडिया अब भी सत्यापित यूआरएल पर रहता है, स्टेटस 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 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित