मुख्य सामग्री पर जाएं
Ayrshare TikTok API का उपयोग करके आपके व्यक्तिगत या business TikTok खाते के लिए TikTok videos का सीधे प्रकाशन, comment प्रबंधन, और उन्नत analytics की पुनर्प्राप्ति प्रदान करता है।TikTok video और photos को asynchronously प्रोसेस करता है, इसलिए JSON प्रतिक्रिया तत्काल और शेड्यूल किए गए दोनों posts के लिए status: “pending” होगी। एक बार TikTok प्रसंस्करण पूरा कर लेता है, तो आपका पंजीकृत Scheduled Action webhook कॉल किया जाएगा।

TikTok Video Post

एक बुनियादी TikTok video post के लिए JSON जो सीधे प्रकाशित होता है:
TikTok Video Post
उदाहरण JSON post प्रतिक्रिया:
TikTok Video Post Response
  • TikTok वर्तमान में पोस्ट text में line breaks का समर्थन नहीं करता। शामिल line breaks अनदेखे किए जाएँगे।
  • या तो एक वीडियो या 35 तक छवियाँ प्रकाशित की जा सकती हैं। TikTok वीडियो और छवियों के संयोजन का समर्थन नहीं करता। अधिक विवरण के लिए कृपया नीचे देखें।
  • यदि वीडियो एक ज्ञात extension में समाप्त नहीं होता है, तो isVideo का उपयोग करें।
  • TikTok पोस्ट text के बिना media भेजने का भी समर्थन करता है। यदि आप पोस्ट text शामिल नहीं करना चाहते तो एक खाली String post: "" भेजें।
  • अधिक जानकारी के लिए TikTok Media Guidelines और TikTok Authorization देखें।

TikTok Video आवश्यकताएँ

  • कृपया TikTok Video Requirements देखें।
  • वीडियो mp4 जैसे ज्ञात video extension में समाप्त होना चाहिए। कृपया या तो URL को reverse proxy करें, एक CDN के साथ vanity URL जोड़ें, या /media endpoint का उपयोग करें।
  • TikTok की पोस्ट text अक्षर सीमा 2,200 है।
TikTok API video publishing को 6 videos प्रति मिनट तक सीमित करता है, प्रति दिन 15 videos की ऊपरी सीमा के साथ।

TikTok Image Post

एक बुनियादी TikTok image (photo) post के लिए JSON जो सीधे प्रकाशित होता है:
TikTok Image Post
उदाहरण JSON प्रतिक्रिया:
TikTok Image Post Response
  • TikTok वर्तमान में पोस्ट text में line breaks का समर्थन नहीं करता। शामिल line breaks अनदेखे किए जाएँगे।
  • या तो एक वीडियो या 35 तक छवियाँ प्रकाशित की जा सकती हैं।
  • TikTok वीडियो और छवियों के संयोजन का समर्थन नहीं करता। अधिक विवरण के लिए कृपया नीचे देखें।
  • छवियाँ JPG, JPEG, या WEBP प्रकार की होनी चाहिए। TikTok PNG media फ़ाइलें स्वीकार नहीं करता।
  • आप imageCoverIndex के साथ छवियों में से एक को cover photo के रूप में भी चुन सकते हैं। Default रूप से, पहली छवि का उपयोग किया जाता है। विवरण के लिए कृपया नीचे देखें।

TikTok Image आवश्यकताएँ

  • कृपया TikTok Image Requirements देखें।
  • प्रति छवि 20 MB पर एक पोस्ट में 35 तक छवियाँ शामिल की जा सकती हैं।
  • छवियाँ JPG, JPEG, या WEBP प्रकार की होनी चाहिए। TikTok PNG media फ़ाइलें स्वीकार नहीं करता।
  • TikTok की पोस्ट text अक्षर सीमा 2,200 है।
TikTok API video publishing को 6 photos प्रति मिनट तक सीमित करता है, प्रति दिन 15 photos की ऊपरी सीमा के साथ।

TikTok प्रसंस्करण

TikTok videos और छवियों का asynchronous प्रसंस्करण करता है, इसलिए प्रतिक्रिया में id फ़ील्ड "pending" पर सेट होगी। TikTok द्वारा अपना प्रसंस्करण पूरा करने के बाद, आमतौर पर 1 - 2 मिनट के भीतर, id फ़ील्ड को TikTok video id के साथ अपडेट किया जाएगा और एक postUrl जोड़ा जाएगा।
  • आप webhooks या /history endpoint का उपयोग करके TikTok पोस्ट की अंतिम स्थिति पुनर्प्राप्त कर सकते हैं और उपलब्ध होने में आमतौर पर 1-2 मिनट लगते हैं।
  • जब user TikTok मोबाइल app में वीडियो प्रकाशित करता है, तो subAction: "tikTokPublished" के साथ एक “scheduled” webhook भेजा जाएगा।
  • TikTok पोस्ट पर एक पहला comment deferred होता है: यह स्वचालित रूप से पोस्ट होता है जब tikTokPublished webhook वास्तविक video id को हल करता है, publish time पर नहीं। Video visibility public होनी चाहिए, अन्यथा पहला comment पोस्ट नहीं किया जा सकता और एक comment error लौटाया जाता है।
  • यदि कोई error होता है, जैसे TikTok वीडियो प्रोसेस करने में असमर्थ था या Ayrshare आंतरिक परीक्षण विफल हुए, तो id फ़ील्ड “failed” पर सेट होगी और errors फ़ील्ड में error विवरण शामिल होंगे।
  • idShare का उपयोग pending video को आंतरिक रूप से referencing के लिए किया जाता है।

TikTok विकल्प

TikTok वीडियो या छवियों को प्रकाशित करते समय अतिरिक्त विकल्प उपलब्ध हैं। Video Publishing उदाहरण:
TikTok Video Publishing
Image Publishing उदाहरण:
TikTok Image Publishing

विकल्प

TikTok posts के लिए निम्नलिखित विकल्प उपलब्ध हैं। उन्हें tikTokOptions object में जोड़ा जाना चाहिए। प्रत्येक विकल्प पर अधिक विवरण के लिए कृपया नीचे देखें।
TikTok Options
autoAddMusic
boolean
डिफ़ॉल्ट:false
क्या पोस्ट में स्वचालित रूप से अनुशंसित संगीत जोड़ना है। यदि आप इस फ़ील्ड को true पर सेट करते हैं, तो आप बाद में TikTok app में संगीत बदल सकते हैं।Media type: image
disableComments
boolean
डिफ़ॉल्ट:false
क्या प्रकाशित पोस्ट पर comments अक्षम करना है।Media type: video, image
disableDuet
boolean
डिफ़ॉल्ट:false
प्रकाशित वीडियो पर duets अक्षम करें।Media type: video
disableStitch
boolean
डिफ़ॉल्ट:false
प्रकाशित वीडियो पर stitch अक्षम करें।Media type: video
draft
boolean
डिफ़ॉल्ट:false
क्या एक draft पोस्ट बनाना है।अधिक जानकारी के लिए draft विकल्प देखें।Media type: video or image
isAIGenerated
boolean
डिफ़ॉल्ट:false
क्या वीडियो पोस्ट के लिए AI-generated content toggle सक्षम करना है।यदि आप toggle सक्षम करते हैं, तो पोस्ट होने के बाद आपके वीडियो को “Creator labeled as AI-generated” लेबल किया जाएगा और इसे बदला नहीं जा सकता। “Creator labeled as AI-generated” लेबल इंगित करता है कि सामग्री पूरी तरह से AI-generated थी या AI के साथ महत्वपूर्ण रूप से संपादित की गई थी।
AI-generated content सेटिंग चालू करने से आपके वीडियो के वितरण पर तब तक प्रभाव नहीं पड़ेगा जब तक कि यह TikTok के Community Guidelines का उल्लंघन न करे।
Media type: video
isBrandedContent
boolean
डिफ़ॉल्ट:false
क्या Branded Content toggle सक्षम करना है। यदि यह फ़ील्ड true पर सेट है, तो वीडियो को Branded Content के रूप में लेबल किया जाएगा, यह इंगित करते हुए कि आप एक brand के साथ paid partnership में हैं। वीडियो पर “Paid partnership” लेबल संलग्न किया जाएगा।Media type: video, image
isBrandOrganic
boolean
डिफ़ॉल्ट:false
क्या Brand Organic Content toggle सक्षम करना है। यदि यह फ़ील्ड true पर सेट है, तो वीडियो को Brand Organic Content के रूप में लेबल किया जाएगा, यह इंगित करते हुए कि आप स्वयं को या अपने खुद के व्यवसाय को promote कर रहे हैं। वीडियो पर “Promotional content” लेबल संलग्न किया जाएगा।Media type: video, image
imageCoverIndex
number
डिफ़ॉल्ट:"0"
पोस्ट के लिए cover के रूप में उपयोग किए जाने वाले mediaUrls का index।Media type: image
title
string
पोस्ट का शीर्षक।Media type: image
thumbNailOffset
number
वीडियो cover के लिए उपयोग किए जाने वाले frame।अधिक जानकारी के लिए video thumbnail विकल्प देखें।Media type: video
visibility
string
डिफ़ॉल्ट:"public"
पोस्ट को कैसे साझा किया जाता है और कौन इसे देख सकता है।मान: public, private, followers, या friendsअधिक जानकारी के लिए visibility विकल्प देखें।Media type: image

Visibility विकल्प

Private posts एक pending स्थिति में रहेंगे और पोस्ट सार्वजनिक होने तक कोई TikTok webhook नहीं भेजा जाएगा।

Video Thumbnail

एक TikTok वीडियो के लिए thumbnail, जिसे cover photo भी कहा जाता है, सेट करने के दो तरीके हैं:
  1. एक thumbnail frame सेट करने के लिए thumbNailOffset parameter का उपयोग करना।
  2. एक URL से thumbnail छवि सेट करने के लिए thumbNail parameter का उपयोग करना।
thumbnail सेट करने के लिए केवल videos समर्थित हैं।

Thumbnail Offset

एक offset frame का चयन करके TikTok वीडियो के लिए thumbnail सेट करें।
TikTok Video Thumbnail Offset
Offset thumbnail frame का मिलीसेकंड में स्थान है। Default मान 0 है, जो वीडियो का पहला frame है।

Thumbnail URL

URL से एक छवि upload करके TikTok वीडियो के लिए thumbnail सेट करें।
TikTok Video Thumbnail URL
यदि आप thumbNail parameter का उपयोग करते हैं, तो thumbNailOffset parameter अनदेखा किया जाएगा। अधिक जानकारी के लिए कृपया TikTok Thumbnail Requirements देखें।

TikTok Mentions

पोस्ट text में @handle जोड़कर किसी अन्य TikTok handle का उल्लेख करें। उदाहरण के लिए:
TikTok Mention
कृपया mentions पर महत्वपूर्ण नियमों की समीक्षा करें।

TikTok Draft Post

एक TikTok video या image के लिए draft पोस्ट बनाएँ, जिससे आप प्रकाशित करने से पहले video या image को संपादित कर सकते हैं।
TikTok Video Draft Post
Draft video या image पोस्ट TikTok app की नीचे पंक्ति में notifications Inbox के अंतर्गत मिलेगी। एक System notifications संदेश देखें और फिर शीर्ष Your content from Ayrshare is ready संदेश पर क्लिक करें। वीडियो प्रकाशित होने तक Ayrshare postUrl pending स्थिति में रहेगा। Draft posts पर पहला comment समर्थित नहीं है। TikTok Draft Post

Authorization Refresh

Social Accounts पेज के माध्यम से TikTok को हर साल पुनः authorize किया जाना चाहिए।
  • authorization समाप्ति से 15 दिन पहले एक email और webhook social action notification भेजा जाएगा।
  • Refresh required date और शेष दिन /user endpoint से पुनर्प्राप्त किए जा सकते हैं।

अक्षर सीमाएँ

अधिक जानकारी के लिए कृपया TikTok Character Limits देखें।

अतिरिक्त जानकारी

TikTok API का उपयोग करने पर अतिरिक्त उदाहरण