> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok API

> TikTok API का उपयोग करके पोस्ट करने के विकल्प

<Info>
  Ayrshare TikTok API का उपयोग करके आपके व्यक्तिगत या business TikTok खाते के लिए [TikTok videos का सीधे प्रकाशन](https://www.ayrshare.com/blog/introducing-tiktok-direct-publishing-analytics-and-commenting/), comment प्रबंधन, और उन्नत analytics की पुनर्प्राप्ति प्रदान करता है।

  TikTok video और photos को asynchronously प्रोसेस करता है, इसलिए JSON प्रतिक्रिया तत्काल और शेड्यूल किए गए दोनों posts के लिए status: "pending" होगी। एक बार TikTok प्रसंस्करण पूरा कर लेता है, तो आपका पंजीकृत [Scheduled Action webhook](/apis/webhooks/actions#scheduled-action) कॉल किया जाएगा।
</Info>

## TikTok Video Post

एक बुनियादी TikTok video post के लिए JSON जो सीधे प्रकाशित होता है:

```json TikTok Video Post theme={"system"}
{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"]
}
```

उदाहरण JSON post प्रतिक्रिया:

```json TikTok Video Post Response theme={"system"}
{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "video.7088122496758679353.nzLqBWbf",
      "id": "pending",
      "isVideo": true,
      "platform": "tiktok"
    }
  ],
  "id": "lb42orDhySAZmLWtj6b6",
  "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1",
  "post": "The best TikTok video ever #bestvideo"
}
```

<ul class="custom-bullets">
  <li>
    TikTok वर्तमान में पोस्ट text में line breaks का समर्थन नहीं करता। शामिल line breaks अनदेखे किए जाएँगे।
  </li>

  <li>
    या तो एक वीडियो या 35 तक छवियाँ प्रकाशित की जा सकती हैं। TikTok वीडियो और छवियों के संयोजन का समर्थन नहीं करता। अधिक विवरण के लिए कृपया नीचे देखें।
  </li>

  <li>
    यदि वीडियो एक ज्ञात extension में समाप्त नहीं होता है, तो
    [isVideo](/apis/post/overview#video-extension) का उपयोग करें।
  </li>

  <li>
    TikTok पोस्ट text के बिना media भेजने का भी समर्थन करता है। यदि आप पोस्ट text शामिल नहीं करना चाहते तो
    एक खाली String `post: ""` भेजें।
  </li>

  <li>
    अधिक जानकारी के लिए [TikTok Media Guidelines](/media-guidelines/tiktok) और [TikTok
    Authorization](/dashboard/connect-social-accounts/tiktok) देखें।
  </li>
</ul>

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

<ul class="custom-bullets">
  <li>कृपया [TikTok Video Requirements](/media-guidelines/tiktok#video) देखें।</li>

  <li>
    वीडियो mp4 जैसे ज्ञात video extension में समाप्त होना चाहिए। कृपया या तो URL को reverse proxy करें,
    एक [CDN के साथ vanity URL जोड़ें](https://www.ayrshare.com/blog/how-to-put-a-cdn-in-front-of-firebase-cloud-storage/), या
    [/media](/apis/media/overview) endpoint का उपयोग करें।
  </li>

  <li>TikTok की पोस्ट text अक्षर सीमा 2,200 है।</li>
</ul>

<Note>
  TikTok API video publishing को 6 videos प्रति मिनट तक सीमित करता है, प्रति दिन 15 videos की ऊपरी सीमा के साथ।
</Note>

## TikTok Image Post

एक बुनियादी TikTok image (photo) post के लिए JSON जो सीधे प्रकाशित होता है:

```json TikTok Image Post theme={"system"}
{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": [
    "https://img.ayrshare.com/012/gb.jpg",
    "https://img.ayrshare.com/random/photo-1.jpg"
  ], // Up to 35 images
  "platforms": ["tiktok"]
}
```

उदाहरण JSON प्रतिक्रिया:

```json TikTok Image Post Response theme={"system"}
{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "p_pub_url~v2.7408974036430047275",
      "id": "pending",
      "isVideo": false,
      "platform": "tiktok"
    }
  ],
  "id": "8815mJ5bWApEebWjE233",
  "tikTokId": "p_pub_url~v2.7408974036430047333",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333",
  "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison"
}
```

<ul class="custom-bullets">
  <li>
    TikTok वर्तमान में पोस्ट text में line breaks का समर्थन नहीं करता। शामिल line breaks अनदेखे किए जाएँगे।
  </li>

  <li>या तो एक वीडियो या 35 तक छवियाँ प्रकाशित की जा सकती हैं।</li>

  <li>
    TikTok वीडियो और छवियों के संयोजन का समर्थन नहीं करता। अधिक विवरण के लिए कृपया नीचे देखें।
  </li>

  <li>छवियाँ JPG, JPEG, या WEBP प्रकार की होनी चाहिए। TikTok PNG media फ़ाइलें स्वीकार नहीं करता।</li>

  <li>
    आप `imageCoverIndex` के साथ छवियों में से एक को cover photo के रूप में भी चुन सकते हैं। Default रूप से,
    पहली छवि का उपयोग किया जाता है। विवरण के लिए कृपया नीचे देखें।
  </li>
</ul>

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

<ul class="custom-bullets">
  <li>कृपया [TikTok Image Requirements](/media-guidelines/tiktok#images) देखें।</li>
  <li>प्रति छवि 20 MB पर एक पोस्ट में 35 तक छवियाँ शामिल की जा सकती हैं।</li>
  <li>छवियाँ JPG, JPEG, या WEBP प्रकार की होनी चाहिए। TikTok PNG media फ़ाइलें स्वीकार नहीं करता।</li>
  <li>TikTok की पोस्ट text अक्षर सीमा 2,200 है।</li>
</ul>

<Note>
  TikTok API video publishing को 6 photos प्रति मिनट तक सीमित करता है, प्रति दिन 15 photos की ऊपरी सीमा के साथ।
</Note>

## TikTok प्रसंस्करण

TikTok videos और छवियों का asynchronous प्रसंस्करण करता है, इसलिए प्रतिक्रिया में `id` फ़ील्ड `"pending"` पर सेट होगी।
TikTok द्वारा अपना प्रसंस्करण पूरा करने के बाद, आमतौर पर 1 - 2 मिनट के भीतर, `id` फ़ील्ड को TikTok video `id` के साथ अपडेट किया जाएगा और एक `postUrl` जोड़ा जाएगा।

<ul class="custom-bullets">
  <li>
    आप [webhooks](/apis/webhooks/actions#tiktok-publishing-webhook) या
    [/history](/apis/history/overview) endpoint का उपयोग करके TikTok पोस्ट की अंतिम स्थिति पुनर्प्राप्त कर सकते हैं और उपलब्ध होने में आमतौर पर 1-2 मिनट लगते हैं।
  </li>

  <li>
    जब user TikTok मोबाइल app में वीडियो प्रकाशित करता है, तो `subAction: "tikTokPublished"` के साथ एक "scheduled" webhook भेजा जाएगा।
  </li>

  <li>
    TikTok पोस्ट पर एक [पहला comment](/apis/post/overview#first-comment) deferred होता है: यह स्वचालित रूप से पोस्ट होता है
    जब `tikTokPublished` webhook वास्तविक video `id` को हल करता है, publish
    time पर नहीं। Video `visibility` `public` होनी चाहिए, अन्यथा पहला comment पोस्ट नहीं किया जा सकता और एक
    comment error लौटाया जाता है।
  </li>

  <li>
    यदि कोई error होता है, जैसे TikTok वीडियो प्रोसेस करने में असमर्थ था या Ayrshare आंतरिक परीक्षण
    विफल हुए, तो `id` फ़ील्ड "failed" पर सेट होगी और `errors` फ़ील्ड में error
    विवरण शामिल होंगे।
  </li>

  <li>`idShare` का उपयोग pending video को आंतरिक रूप से referencing के लिए किया जाता है।</li>
</ul>

## TikTok विकल्प

TikTok वीडियो या छवियों को प्रकाशित करते समय [अतिरिक्त विकल्प](/apis/post/social-networks/tiktok#available-tiktok-options) उपलब्ध हैं।

Video Publishing उदाहरण:

```json TikTok Video Publishing theme={"system"}
{
  "tikTokOptions": {
    "disableComments": true, // Default false. Disable comments on the published video.
    "disableDuet": true, // Default false. Disable duets on the published video.
    "disableStitch": true // Default false. Disable stitches on the published video.
  }
}
```

Image Publishing उदाहरण:

```json TikTok Image Publishing theme={"system"}
{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}
```

### विकल्प

TikTok posts के लिए निम्नलिखित विकल्प उपलब्ध हैं।
उन्हें `tikTokOptions` object में जोड़ा जाना चाहिए।
प्रत्येक विकल्प पर अधिक विवरण के लिए कृपया नीचे देखें।

```json TikTok Options theme={"system"}
{
  "post": "The best TikTok video ever #bestvideo",
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "autoAddMusic": true,
    "disableComments": true,
    "disableDuet": true,
    "disableStitch": true,
    "draft": true,
    "isAIGenerated": true,
    "isBrandedContent": true,
    "isBrandOrganic": true,
    "imageCoverIndex": 1,
    "title": "Amazing images",
    "thumbNailOffset": 30000,
    "visibility": "public"
  }
}
```

<ParamField body="autoAddMusic" type="boolean" default={false}>
  क्या पोस्ट में स्वचालित रूप से अनुशंसित संगीत जोड़ना है।
  यदि आप इस फ़ील्ड को `true` पर सेट करते हैं, तो आप बाद में TikTok app में संगीत बदल सकते हैं।

  Media type: image
</ParamField>

<ParamField body="disableComments" type="boolean" default={false}>
  क्या प्रकाशित पोस्ट पर comments अक्षम करना है।

  Media type: video, image
</ParamField>

<ParamField body="disableDuet" type="boolean" default={false}>
  प्रकाशित वीडियो पर duets अक्षम करें।

  Media type: video
</ParamField>

<ParamField body="disableStitch" type="boolean" default={false}>
  प्रकाशित वीडियो पर stitch अक्षम करें।

  Media type: video
</ParamField>

<ParamField body="draft" type="boolean" default={false}>
  क्या एक draft पोस्ट बनाना है।

  अधिक जानकारी के लिए [draft विकल्प](/apis/post/social-networks/tiktok#tiktok-video-draft-post) देखें।

  Media type: video or image
</ParamField>

<ParamField body="isAIGenerated" type="boolean" default={false}>
  क्या वीडियो पोस्ट के लिए AI-generated content toggle सक्षम करना है।

  यदि आप toggle सक्षम करते हैं, तो पोस्ट होने के बाद आपके वीडियो को "Creator labeled as AI-generated" लेबल किया जाएगा और इसे बदला नहीं जा सकता।
  "Creator labeled as AI-generated" लेबल इंगित करता है कि सामग्री पूरी तरह से AI-generated थी या AI के साथ महत्वपूर्ण रूप से संपादित की गई थी।

  <Note>
    AI-generated content सेटिंग चालू करने से आपके वीडियो के वितरण पर तब तक प्रभाव नहीं पड़ेगा जब तक कि
    यह TikTok के [Community
    Guidelines](https://www.tiktok.com/community-guidelines/en/) का उल्लंघन न करे।
  </Note>

  Media type: video
</ParamField>

<ParamField body="isBrandedContent" type="boolean" default={false}>
  क्या <a href="https://creatormarketplace.tiktok.com/help#/doc/9493/10008169">Branded Content</a> toggle सक्षम करना है। यदि यह फ़ील्ड `true` पर सेट है, तो वीडियो को Branded Content के रूप में लेबल किया जाएगा, यह इंगित करते हुए कि आप एक brand के साथ paid partnership में हैं। वीडियो पर "Paid partnership" लेबल संलग्न किया जाएगा।

  Media type: video, image
</ParamField>

<ParamField body="isBrandOrganic" type="boolean" default={false}>
  क्या Brand Organic Content toggle सक्षम करना है। यदि यह फ़ील्ड `true` पर सेट है, तो वीडियो को Brand Organic Content के रूप में लेबल किया जाएगा, यह इंगित करते हुए कि आप स्वयं को या अपने खुद के व्यवसाय को promote कर रहे हैं। वीडियो पर "Promotional content" लेबल संलग्न किया जाएगा।

  Media type: video, image
</ParamField>

<ParamField body="imageCoverIndex" type="number" default="0">
  पोस्ट के लिए cover के रूप में उपयोग किए जाने वाले `mediaUrls` का index।

  Media type: image
</ParamField>

<ParamField body="title" type="string">
  पोस्ट का शीर्षक।

  Media type: image
</ParamField>

<ParamField body="thumbNailOffset" type="number">
  वीडियो cover के लिए उपयोग किए जाने वाले frame।

  अधिक जानकारी के लिए [video thumbnail विकल्प](/apis/post/social-networks/tiktok#video-thumbnail) देखें।

  Media type: video
</ParamField>

<ParamField body="visibility" type="string" default="public">
  पोस्ट को कैसे साझा किया जाता है और कौन इसे देख सकता है।

  मान: `public`, `private`, `followers`, या `friends`।

  अधिक जानकारी के लिए [visibility विकल्प](/apis/post/social-networks/tiktok#visibility-options) देखें।

  Media type: image
</ParamField>

### Visibility विकल्प

| Visibility | विवरण                                    |
| :--------- | :--------------------------------------- |
| public     | सभी TikTok users को दिखाई देता है।       |
| private    | निजी, केवल खाते को स्वयं दिखाई देता है।  |
| followers  | केवल खाते के followers को दिखाई देता है। |
| friends    | केवल परस्पर followers को दिखाई देता है।  |

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 सेट करें।

```json TikTok Video Thumbnail Offset theme={"system"}
{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}
```

Offset thumbnail frame का मिलीसेकंड में स्थान है। Default मान `0` है, जो वीडियो का पहला frame है।

### Thumbnail URL

URL से एक छवि upload करके TikTok वीडियो के लिए thumbnail सेट करें।

```json TikTok Video Thumbnail URL theme={"system"}
{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

यदि आप `thumbNail` parameter का उपयोग करते हैं, तो `thumbNailOffset` parameter अनदेखा किया जाएगा।

अधिक जानकारी के लिए कृपया [TikTok Thumbnail Requirements](/media-guidelines/tiktok#video-thumbnail) देखें।

## TikTok Mentions

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

```json TikTok Mention theme={"system"}
{
  "post": "Love the @ayrshare social media api"
}
```

<Warning>
  कृपया mentions पर [महत्वपूर्ण नियमों](/testing/post-verification#mentions) की समीक्षा करें।
</Warning>

## TikTok Draft Post

एक TikTok video या image के लिए draft पोस्ट बनाएँ, जिससे आप प्रकाशित करने से पहले video या image को संपादित कर सकते हैं।

```json TikTok Video Draft Post theme={"system"}
{
  "post": "The best TikTok video ever #bestvideo", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "draft": true
  }
}
```

Draft video या image पोस्ट TikTok app की नीचे पंक्ति में notifications **Inbox** के अंतर्गत मिलेगी।
एक **System notifications** संदेश देखें और फिर शीर्ष **Your content from Ayrshare is ready** संदेश पर क्लिक करें।

वीडियो प्रकाशित होने तक Ayrshare `postUrl` `pending` स्थिति में रहेगा। Draft posts पर पहला comment समर्थित नहीं है।

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/tiktok-draft-post.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=6e7fdce5ef106f6af6cd060bfbc446ba" alt="TikTok Draft Post" class="center" width="278" height="600" data-path="images/apis/post/tiktok-draft-post.webp" />

## Authorization Refresh

Social Accounts पेज के माध्यम से TikTok को *हर साल* पुनः authorize किया जाना चाहिए।

<ul class="custom-bullets">
  <li>
    authorization समाप्ति से 15 दिन पहले एक email और webhook social action notification भेजा जाएगा।
  </li>

  <li>
    Refresh required date और शेष दिन [/user](/apis/user/overview) endpoint से पुनर्प्राप्त किए जा सकते हैं।
  </li>
</ul>

## अक्षर सीमाएँ

अधिक जानकारी के लिए कृपया [TikTok Character Limits](/help-center/technical-support/character_limits#tiktok-character-limits) देखें।

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

[TikTok API का उपयोग करने पर अतिरिक्त उदाहरण](https://www.ayrshare.com/blog/tiktok-api-how-to-post-to-tiktok-using-a-social-media-api/)।