लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

एपीआयद्वारे TikTok वर व्हिडिओ कसा पोस्ट करायचा

TikTok च्या व्यवसाय एपीआयद्वारे व्हिडिओ पोस्ट करण्यासाठी POST /business/video/publish/ ला खात्याचा business_id, डोमेन किंवा यूआरएल प्रीफिक्सवर सत्यापित video_url, कॅप्शन आणि सेटिंग्ज असलेले post_info ऑब्जेक्ट आणि 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 पर्यंत पोहोचते.

share_id

पब्लिश कॉलने परत येतो, उदाहरणार्थ v_pub_url~v1.2345123456789123456, आणि त्याला स्टेटस कॉलमध्ये publish_id म्हणून दिले जाते.

Nov 16, 2023

तेव्हापासून, ज्या यूआरएलचा डोमेन किंवा यूआरएल प्रीफिक्स सत्यापित नाही त्यावरील व्हिडिओ TikTok प्रकाशित करत नाही.

6 a minute

पब्लिश एंडपॉइंटद्वारे प्रति खाते व्हिडिओ पोस्टांवर TikTok ची मर्यादा, दिवसाला जास्तीत जास्त 15.

3 min

PUBLISH_COMPLETE नंतर post_ids दिसण्यासाठी किती वेळ लागू शकतो; TikTok तीन मिनिटांनी पुन्हा प्रयत्न करण्यास सांगते.

post_id

post.publish.publicly_available webhook मध्ये पाठवले जाते, एकदा पोस्ट मॉडरेशन पास झाल्यावर, इनसाइट्स क्वेरी करण्यासाठी तयार.

पहिल्या कॉलपूर्वी काय लागते?

तीन गोष्टी. 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 चालू ठेवलेले आहेत:

Publish a video with curl
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: टोकन एक्स्चेंजमधील खात्याचा open_id.
  • video_url: TikTok डाउनलोड करते ती फाइल, MP4, MOV किंवा WebM, सत्यापित डोमेन किंवा यूआरएल प्रीफिक्सवर.
  • post_info: प्रत्येक कॉलवर आवश्यक, अगदी रिकाम्या ऑब्जेक्ट म्हणूनही, आणि पोस्टच्या सेटिंग्जचे घर.
  • post_info.caption: UTF-16 मध्ये मोजलेले 2,200 अक्षरांपर्यंत, #हॅशटॅग्ज आणि 30 @मेन्शन्सपर्यंत.
  • post_info.is_brand_organic आणि is_branded_content: TikTok च्या तक्त्यात आवश्यक म्हणून चिन्हांकित केलेले Promotional content आणि Paid partnership लेबल.
  • 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 ने.

The publish response
{
  "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 मध्ये:

Publish and follow a video in 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

वेबहुक स्टेटस तपासण्या बदलू शकतो का?

होय, event_type VIDEO साठी /business/webhook/update/ सह सबस्क्राइब करणाऱ्या ॲपसाठी. TikTok फाइल डाउनलोड करून तपासल्यानंतर post.publish.failed किंवा post.publish.complete पाठवते, मॉडरेशन पास झाल्यावर नवीन post_id सह post.publish.publicly_available, आणि पोस्ट सार्वजनिक दृश्यातून यापुढे बाहेर गेल्यास post.publish.no_longer_publicly_available. प्रत्येक इव्हेंटमध्ये publish_id मध्ये टास्क नमूद असतो, जे share_id इतकेच मूल्य आहे.

MCP द्वारे व्हिडिओ कसा पोस्ट करायचा?

https://easycoexistence.com/api/mcp ला जोडलेल्या Claude, ChatGPT किंवा इतर क्लायंटला साध्या शब्दांत विचारा. सहाय्यक list_social_accounts मधील account_id, HTTPS video_url, कॅप्शन आणि कमेंट्स बंद हवे असल्यास disable_comment सह publish_tiktok_post कॉल करतो. परिणामात TikTok चा share_id असतो; account_id आणि त्या share_id दिल्यावर get_tiktok_publish_status, TikTok ची स्टेटस, post_ids आणि reason सध्याच्या स्थितीनुसार परत करतो.

The MCP tool calls and their results
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 चे डीफॉल्ट राखतात, आणि एंडपॉइंट तसे बनवलेले असल्याने व्हिडिओ सार्वजनिक पोस्ट म्हणून प्रकाशित होतो.

Partner API कडील क्रेडेन्शियल्सने काय करता येते?

खात्याच्या वतीने थेट TikTok ला कॉल करता येतो. https://easycoexistence.com/api/v1 वर GET /channels/{id}?credentials=1, तुमची ec_live_ की bearer token म्हणून वापरून, credentials ऑब्जेक्टसह चॅनल परत करते: api_base, business_id, सध्याचा access_token आणि token_expires_at. स्टेटस तपासणी, व्हिडिओ यादी, कमेंट्स आणि इनसाइट्स मग तुमच्या स्वतःच्या कोडमधून चालतात. प्रकाशन हा नियोजनाचा भाग आहे: थेट publish कॉल video_url TikTok ला जसाच्या तसा पाठवतो, यूआरएल गुणधर्म डेव्हलपर ॲपच्या स्वतःच्या ID आणि सीक्रेटने जोडले जातात, आणि easyCoexistence च्या ॲपने सत्यापित केलेला प्रीफिक्स हा त्याचा मीडिया मार्ग आहे, जो publish_tiktok_post वापरते.

Credentials from the Partner API, then a direct status check
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>'

ते कसे सेट करायचे

  1. 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.
  2. 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.
  3. 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/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. 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 webhook मधून मिळतात.
  • टाइम आउट झालेला पब्लिश कॉल पुन्हा पाठवणे. पहिली विनंती TikTok पर्यंत पोहोचली असू शकते, म्हणून पुन्हा पाठवण्यापूर्वी खात्याच्या अलीकडील पोस्ट तपासा.
  • कोड 0 ला लाइव्ह व्हिडिओ मानणे. त्याचा अर्थ TikTok ने टास्क स्वीकारला असा होतो, आणि डाउनलोडनंतरही फाइल तिच्या तपासण्यांमध्ये अयशस्वी होऊ शकते.
EasyCoexistence सोबत हे करताना

प्रति कनेक्शन दरमहा 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 API थेट व्हिडिओ फाइल अपलोड करू शकते का?

/business/video/publish/ द्वारे नाही. ते video_url घेते आणि तिथून फाइल आणते, त्यामुळे व्हिडिओला सत्यापित डोमेन किंवा यूआरएल प्रीफिक्सवर यूआरएल असणे आवश्यक आहे.

API द्वारे पोस्ट केलेल्या व्हिडिओचा ID कसा मिळवायचा?

/business/publish/status/ मधील post_ids वरून, स्टेटस PUBLISH_COMPLETE आणि पोस्ट सार्वजनिक झाल्यावर, किंवा post.publish.publicly_available webhook मधील post_id वरून.

TikTok व्हिडिओ API द्वारे नंतरच्या वेळेसाठी शेड्यूल करता येतो का?

पब्लिश एंडपॉइंट कॉल केल्यावरच पोस्ट करतो आणि त्यात वेळेचे फील्ड नाही. easyCoexistence शेड्यूल केलेल्या पोस्ट स्वतःच्या रांगेत ठेवते आणि तुम्ही ठरवलेल्या वेळी TikTok ला कॉल करते.

पुढे वाचा

एपीआयद्वारे TikTok पोस्ट सेटिंग्ज: प्रायव्हसी, कमेंट्स, Duet आणि StitchTikTok च्या पब्लिश एंडपॉइंट्सना लागणाऱ्या सेटिंग्ज: प्रायव्हसी, कमेंट, Duet, Stitch, कव्हर, ब्रँड व AI लेबल आणि प्रत्येक खात्याला परवानगी असलेली मूल्ये.TikTok मीडिया यूआरएल: पडताळलेले डोमेन आणि यूआरएल प्रीफिक्सTikTok व्यवसाय एपीआय पोस्टचा मीडिया पडताळलेले डोमेन आणि यूआरएल प्रीफिक्समधून कसा घेते: DNS TXT आणि signature फाईल तपासणी, तसेच property एंडपॉइंट्स.एपीआय द्वारे TikTok पोस्टचे प्रकाशन स्टेटस कसे तपासावेएपीआय द्वारे प्रकाशित केलेली TikTok पोस्ट कशी तपासायची: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE आणि FAILED, पोस्ट आयडी आणि अपयशाची कारणे.TikTok व्हिडिओ आवश्यकता: एपीआयसाठी फॉरमॅट, आकार आणि लांबीTikTok एपीआयद्वारे प्रकाशित होणारे व्हिडिओ: MP4, MOV किंवा WebM, 3 ते 600 सेकंद, 1 GB पर्यंत, 23 ते 60 FPS, TikTok स्वतः डाउनलोड करणारा यूआरएल.TikTok API for Business चे वेबहुक सेट करणेTikTok API for Business ॲप वेबहुकला कसे सबस्क्राइब करावे: /business/webhook/update/, VIDEO व COMMENT इव्हेंट, कॉलबॅक नियम आणि Tiktok-Signature.TikTok API for Business चे ॲक्सेस टोकन: 24 तास, रिफ्रेश आणि रद्द करणेTikTok API for Business चे टोकन कसे मिळतात, ते 24 तास वैध असतात, रिफ्रेश टोकन एक वर्ष आणि त्यांचे नूतनीकरण व रद्द करणे.

तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.

कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.

  • 3 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: