एपीआई के ज़रिए TikTok पर वीडियो कैसे पोस्ट करें
TikTok के बिज़नेस एपीआई से वीडियो पोस्ट करने के लिए, खाते का business_id, सत्यापित डोमेन या यूआरएल प्रीफ़िक्स पर video_url, और कैप्शन व सेटिंग वाला post_info ऑब्जेक्ट लेकर POST /business/video/publish/ भेजें, साथ में Access-Token हेडर दें। TikTok एक share_id लौटाता है; उसे publish_id के रूप में /business/publish/status/ को तब तक भेजें जब तक स्टेटस PUBLISH_COMPLETE न दिखाए और post_ids न आ जाएँ।
easyCoexistence Claude, ChatGPT या आपके अपने एजेंट से publish_tiktok_post के ज़रिए TikTok वीडियो पोस्ट करता है: एक HTTPS लिंक, कैप्शन और कमेंट चालू हैं या नहीं, यह दें; फिर get_tiktok_publish_status से पोस्ट को ट्रैक करें, जबकि फ़ाइल अपने सत्यापित मीडिया रूट से TikTok तक पहुँचती है।
पब्लिश कॉल से लौटता है, जैसे v_pub_url~v1.2345123456789123456, और उसे स्टेटस कॉल में publish_id के रूप में भेजा जाता है।
तब से, TikTok उन यूआरएल से वीडियो पब्लिश करने से मना करता है जिनका डोमेन या यूआरएल प्रीफ़िक्स सत्यापित नहीं है।
पब्लिश एंडपॉइंट के ज़रिए प्रति खाते वीडियो पोस्ट पर TikTok की सीमा, दिन में अधिकतम 15।
PUBLISHED_COMPLETE के बाद post_ids दिखने में कितना समय लग सकता है; TikTok कहता है कि तीन मिनट बाद फिर कोशिश करें।
पोस्ट मॉडरेशन पास करने के बाद post.publish.publicly_available वेबहुक में भेजा जाता है, ताकि इनसाइट्स क्वेरी किए जा सकें।
पहली कॉल से पहले क्या चाहिए?
तीन चीज़ें। एक TikTok खाते का एक्सेस टोकन और खाते का open_id, जो टोकन एक्सचेंज से मिलता है; एक डेवलपर ऐप जिसमें TikTok Accounts के तहत Video Publish परमिशन हो; और वीडियो एक सार्वजनिक HTTPS या HTTP यूआरएल पर, जो ऐप के लिए सत्यापित किसी डोमेन या यूआरएल प्रीफ़िक्स के नीचे हो। TikTok फ़ाइल खुद डाउनलोड करता है, इसलिए वह पहुँच योग्य रहनी चाहिए, और TikTok ऐसा यूआरएल सुझाता है जो कम से कम 30 मिनट तक चले।
पब्लिश अनुरोध कैसा दिखता है?
https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ पर एक POST, जिसमें खाते का टोकन Access-Token हेडर में और Content-Type application/json पर सेट हो। JSON बॉडी में खाते की पहचान business_id में, फ़ाइल video_url में और पोस्ट की सेटिंग post_info में होती हैं; यह उदाहरण एक कैप्शन वाला वीडियो पब्लिश करता है, जिसमें कमेंट, Duet और Stitch चालू रहने दिए गए हैं:
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 menu is live #food",
"is_brand_organic": false,
"is_branded_content": false,
"disable_comment": false,
"disable_duet": false,
"disable_stitch": false
}
}'हर बॉडी फ़ील्ड क्या करता है?
TikTok का संदर्भ दस्तावेज़ वीडियो पोस्ट के लिए जो फ़ील्ड सूचीबद्ध करता है, वे सबसे ऊपर वाले स्तर से शुरू करके। कवर, AI-generated लेबल, स्थान, ड्राफ़्ट और केवल-विज्ञापन विकल्प उसी बॉडी में होते हैं:
business_id: TikTok के टोकन एक्सचेंज से मिला खाते काopen_id।video_url: वह फ़ाइल जिसे TikTok डाउनलोड करता है, MP4, MOV या WebM, सत्यापित डोमेन या यूआरएल प्रीफ़िक्स पर।post_info: हर कॉल पर ज़रूरी है, खाली ऑब्जेक्ट के रूप में भी, और इसमें पोस्ट की सेटिंग रहती हैं।post_info.caption: UTF-16 में गिने गए 2,200 अक्षरों तक, #hashtags और 30 @mentions तक।post_info.is_brand_organicऔरis_branded_content: Promotional content और Paid partnership लेबल, जिन्हें TikTok की तालिका ज़रूरी बताती है।post_info.disable_comment,disable_duetऔरdisable_stitch: true पर कमेंट, Duet या Stitch बंद हो जाते हैं; तीनों डिफ़ॉल्ट रूप से false होते हैं।
TikTok क्या लौटाता है?
सामान्य एनवेलप, जिसके data में पब्लिशिंग टास्क का ID होता है। कोड 0 का मतलब है कि TikTok ने टास्क स्वीकार कर लिया, न कि वीडियो लाइव है: TikTok को अब भी फ़ाइल डाउनलोड करनी है, उसकी जाँच करनी है और पोस्ट को मॉडरेट करना है। TikTok के उदाहरणों में वीडियो का share_id v_pub_url से और फ़ोटो पोस्ट का p_pub_url से शुरू होता है।
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}पोस्ट लाइव होने तक उसे कैसे ट्रैक करें?
GET /business/publish/status/ से, जिसमें business_id और share_id को publish_id के रूप में भेजा जाए। जब TikTok फ़ाइल प्राप्त कर रहा हो तब स्टेटस PROCESSING_DOWNLOAD दिखाता है, मॉडरेशन पास होने पर PUBLISH_COMPLETE, या कारण के साथ FAILED। जब पोस्ट सार्वजनिक रूप से दिखने योग्य हो, तब PUBLISH_COMPLETE के साथ post_ids आता है, और इसमें तीन मिनट तक की देरी हो सकती है। पूरा फ़्लो Python में:
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"] # open_id from the token exchange
def call(method, path, **kwargs):
body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
if body.get("code") != 0: # errors arrive in code, usually with HTTP 200
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
return body["data"]
share_id = call("POST", "business/video/publish/", json={
"business_id": BUSINESS_ID,
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {"caption": "Our new menu is live #food",
"is_brand_organic": False, "is_branded_content": False},
})["share_id"]
for _ in range(30):
time.sleep(60) # each check is a call; TikTok's stages take minutes
s = call("GET", "business/publish/status/",
params={"business_id": BUSINESS_ID, "publish_id": share_id})
if s["status"] == "FAILED":
raise RuntimeError(s.get("reason"))
if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
print("Live:", s["post_ids"])
breakक्या वेबहुक स्टेटस जाँचों की जगह ले सकता है?
हाँ, उस ऐप के लिए जो /business/webhook/update/ के साथ event_type VIDEO की सदस्यता लेता है। फ़ाइल डाउनलोड और जाँच के बाद TikTok post.publish.failed या post.publish.complete भेजता है, मॉडरेशन पास होने पर नए post_id के साथ post.publish.publicly_available, और पोस्ट बाद में सार्वजनिक दृश्य से हट जाए तो post.publish.no_longer_publicly_available। हर इवेंट publish_id में टास्क का नाम देता है, जो share_id के समान मान है।
MCP के ज़रिए वीडियो कैसे पोस्ट करें?
Claude, ChatGPT या https://easycoexistence.com/api/mcp से जुड़े किसी अन्य क्लाइंट से सादे शब्दों में माँगें। असिस्टेंट list_social_accounts से मिले account_id के साथ publish_tiktok_post कॉल करता है, एक HTTPS video_url, कैप्शन और, अगर आप कमेंट बंद चाहते हैं, disable_comment के साथ। नतीजे में TikTok का share_id होता है, और get_tiktok_publish_status को account_id और उस share_id के साथ दें तो वह TikTok का स्टेटस, post_ids और कारण जैसा है वैसा लौटाता है।
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"caption": "Our new menu is live #food",
"disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
"note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }publish_tiktok_post TikTok को क्या भेजता है?
उसी एंडपॉइंट पर एक कॉल, जो आपके अनुरोध से भरी जाती है। आपका लिंक easyCoexistence के अपने सत्यापित मीडिया रूट के तहत साइन किए हुए लिंक के रूप में TikTok को जाता है, इसलिए उसे अलग से सत्यापन की ज़रूरत नहीं होती; कैप्शन और disable_comment वैसे ही जाते हैं जैसे आपने दिए; और is_brand_organic तथा is_branded_content false के रूप में जाते हैं। बाकी सेटिंग, जैसे Duet, Stitch, कवर और AI-generated लेबल, TikTok के डिफ़ॉल्ट पर रहती हैं, और वीडियो एक सार्वजनिक पोस्ट के रूप में पब्लिश होता है, जैसा एंडपॉइंट इसके लिए बना है।
पार्टनर एपीआई के क्रेडेंशियल से क्या किया जा सकता है?
खाते के तौर पर सीधे TikTok को कॉल करें। https://easycoexistence.com/api/v1 पर GET /channels/{id}?credentials=1, अपनी ec_live_ कुंजी को बियरर टोकन के रूप में देते हुए, credentials ऑब्जेक्ट वाला चैनल लौटाता है: api_base, business_id, मौजूदा access_token और token_expires_at। इसके बाद स्टेटस जाँच, वीडियो सूचियाँ, कमेंट और इनसाइट्स आपके अपने कोड से चल सकते हैं। पब्लिशिंग वह हिस्सा है जिसकी योजना बनानी है: सीधी पब्लिश कॉल video_url को बिना बदले TikTok को भेजती है, यूआरएल प्रॉपर्टी डेवलपर ऐप के अपने ID और सीक्रेट से जोड़ी जाती हैं, और easyCoexistence के ऐप द्वारा सत्यापित प्रीफ़िक्स उसका मीडिया रूट है, जिसे publish_tiktok_post इस्तेमाल करता है।
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# "credentials": {
# "platform": "tiktok",
# "api_base": "https://business-api.tiktok.com/open_api/v1.3",
# "business_id": "<OPEN_ID>",
# "access_token": "<ACCESS_TOKEN>",
# "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'publish_id=<SHARE_ID>'कैसे कॉन्फ़िगर करें
- Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
- Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
- Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.
आम गड़बड़ियाँ
- post_info छोड़ देना। TikTok हर कॉल पर यह ऑब्जेक्ट माँगता है, भले ही कोई सेटिंग न बदली हो।
- पब्लिश के जवाब में पोस्ट ID खोजना। वह केवल share_id लौटाता है; post ID स्टेटस कॉल या publicly_available वेबहुक से आते हैं।
- टाइम-आउट हुई पब्लिश कॉल दोबारा भेजना। पहला अनुरोध TikTok तक पहुँच चुका हो सकता है, इसलिए दोबारा भेजने से पहले खाते की नवीनतम पोस्ट जाँचें।
- कोड 0 को लाइव वीडियो मानना। इसका मतलब है कि TikTok ने टास्क स्वीकार किया, और डाउनलोड के बाद फ़ाइल अब भी अपनी जाँच में विफल हो सकती है।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन बढ़ते हैं वैसे घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
कौन सा एंडपॉइंट TikTok पर वीडियो पोस्ट करता है?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, जिसमें खाते का टोकन Access-Token हेडर में और JSON बॉडी में business_id, video_url और post_info हों।
क्या TikTok एपीआई सीधे वीडियो फ़ाइल अपलोड कर सकता है?
/business/video/publish/ के ज़रिए नहीं। वह video_url लेता है और फ़ाइल वहीं से लाता है, इसलिए वीडियो को सत्यापित डोमेन या यूआरएल प्रीफ़िक्स पर यूआरएल की ज़रूरत होती है।
एपीआई से पब्लिश किए गए वीडियो का ID कैसे पाएँ?
/business/publish/status/ में PUBLISH_COMPLETE होने और पोस्ट सार्वजनिक होने पर post_ids से, या post.publish.publicly_available वेबहुक के post_id से।
क्या एपीआई के ज़रिए TikTok वीडियो बाद के लिए शेड्यूल कर सकते हैं?
पब्लिश एंडपॉइंट कॉल होते ही पोस्ट करता है और उसमें कोई समय फ़ील्ड नहीं है। easyCoexistence शेड्यूल की गई पोस्ट अपनी कतार में रखता है और आपके तय समय पर TikTok को कॉल करता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित