> ## 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.

# Pinterest API

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

## Pinterest पर एक Image Pin पोस्ट करना

Pinterest API के लिए पोस्ट में एक इमेज शामिल करना आवश्यक है। अन्य पैरामीटर वैकल्पिक हैं।
अधिक जानकारी के लिए कृपया [Pinterest Media Guidelines](/media-guidelines/pinterest) और [Pinterest Authorization](/dashboard/connect-social-accounts/pinterest) देखें।

```json Pinterest Post theme={"system"}
{
  "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string
  "platforms": ["pinterest"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"]
}
```

## Pinterest Options

आप `pinterestOptions` पैरामीटर का उपयोग करके पोस्ट के लिए अतिरिक्त विकल्प सेट कर सकते हैं।

```json Pinterest Post theme={"system"}
{
  "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string
  "platforms": ["pinterest"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"],
  "pinterestOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"], // maximum 500 characters
    "boardId": "93383204522",
    "carouselOptions": [
      {
        "title": "Image 1",
        "link": "https://www.cnn.com",
        "description": "Super Image 1"
      },
      {
        "title": "Image 2",
        "link": "https://www.google.com",
        "description": "Super Image 2"
      }
    ],
    "link": "https://www.ayrshare.com", // maximum 2048 characters
    "note": "Private note", // maximum 1000 characters
    "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg",
    "title": "A Pinterest Board for You" // maximum 100 characters
  }
}
```

Pinterest options वैकल्पिक फील्ड हैं जिनका उपयोग पोस्ट को नियंत्रित करने के लिए किया जा सकता है।

<ParamField body="altText" type="array of strings">
  इमेज और वीडियो के लिए वैकल्पिक टेक्स्ट, जो एक्सेसिबिलिटी और स्क्रीन रीडर्स के लिए है। अधिकतम 500 अक्षर।

  अधिक जानकारी के लिए [Pinterest Alternative Text](/apis/post/social-networks/pinterest#alternative-text) देखें।
</ParamField>

<ParamField body="boardId" type="string">
  /user/details endpoint से ID निर्दिष्ट करके उपयोगकर्ता के किसी अन्य Pinterest बोर्ड पर पोस्ट करें।

  यदि निर्दिष्ट नहीं किया गया है, तो डिफ़ॉल्ट लिंक किए गए बोर्ड पर पोस्ट होगा।

  अधिक जानकारी के लिए [Pinterest Board ID](/apis/post/social-networks/pinterest#board-id) देखें।
</ParamField>

<ParamField body="carouselOptions" type="array of objects">
  वैकल्पिक टाइटल, लिंक और विवरण के साथ Pinterest carousel के रूप में 5 तक इमेज जोड़ें।

  प्रत्येक ऑब्जेक्ट में शामिल हो सकते हैं: `title`, `link`, और `description`।

  अधिक जानकारी के लिए [Pinterest Image Carousel](/apis/post/social-networks/pinterest#pinterest-image-carousel) देखें।
</ParamField>

<ParamField body="link" type="string">
  जब उपयोगकर्ता पिन इमेज पर क्लिक करेंगे तो उन्हें जिस डेस्टिनेशन URL पर निर्देशित किया जाएगा। अधिकतम 2048 अक्षर।

  आपके पिन के साथ एक क्लिक करने योग्य लिंक बनाता है।

  अधिक जानकारी के लिए [Pin Link](/apis/post/social-networks/pinterest#pin-link) देखें।
</ParamField>

<ParamField body="note" type="string">
  व्यक्तिगत पिन में निजी नोट्स जोड़ें जिन्हें केवल आप और बोर्ड सहयोगी देख सकते हैं। अधिकतम 1000 अक्षर।

  अधिक जानकारी के लिए [Pin Note](/apis/post/social-networks/pinterest#pin-note) देखें।
</ParamField>

<ParamField body="thumbNail" type="string">
  वीडियो पिन के लिए एक थंबनेल सेट करें। PNG या JPG होना चाहिए, वीडियो के समान डायमेंशन, 10MB से कम।

  वीडियो पिन के लिए आवश्यक।

  अधिक जानकारी के लिए [Video Pin (Thumbnail)](/apis/post/social-networks/pinterest#video-pin-thumbnail) देखें।
</ParamField>

<ParamField body="title" type="string">
  पिन का टाइटल जिसे "Add your title" सेक्शन में प्रदर्शित किया जाएगा। अधिकतम 100 अक्षर।

  अधिक जानकारी के लिए [Pin Title](/apis/post/social-networks/pinterest#pin-title) देखें।
</ParamField>

<sup>\*</sup>`post` फील्ड में लिंक क्लिक करने योग्य नहीं हैं। कृपया पिन में क्लिक करने योग्य लिंक जोड़ने के लिए `link` फील्ड का उपयोग करें।

अधिक जानकारी के लिए [Pinterest Media Guidelines](/media-guidelines/pinterest) देखें।

## Alternative Text

Pinterest इमेज या वीडियो में वैकल्पिक टेक्स्ट, जिसे alt text भी कहा जाता है, जोड़ें। Pinterest alt text एक एक्सेसिबिलिटी फीचर है जिसका उपयोग अतिरिक्त उपयोगकर्ता जानकारी और स्क्रीन रीडर्स के लिए किया जाता है।

`pinterestOptions` ऑब्जेक्ट में `altText` का उपयोग करें।

```json Pinterest Alt Text theme={"system"}
{
  "pinterestOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}
```

Alt text 500 अक्षरों तक सीमित है।

## Board ID

[/user/details](/apis/user/pinterest-board) endpoint से प्राप्त ID निर्दिष्ट करके उपयोगकर्ता के किसी अन्य Pinterest बोर्ड पर पोस्ट करें। अन्यथा डिफ़ॉल्ट लिंक किए गए बोर्ड पर पोस्ट होगा।

`pinterestOptions` ऑब्जेक्ट में `boardId` का उपयोग करें।

```json Pinterest Board ID theme={"system"}
{
  "pinterestOptions": {
    "boardId": "93383204522"
  }
}
```

## Character Limits

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

## Pin Link

डेस्टिनेशन URL जिस पर उपयोगकर्ताओं को आपकी पिन इमेज पर क्लिक करने पर निर्देशित किया जाएगा। यह आपके पिन के साथ एक क्लिक करने योग्य लिंक बनाता है। अधिकतम लंबाई 2048 अक्षर है।

`pinterestOptions` ऑब्जेक्ट में `link` का उपयोग करें।

```json Pin Link theme={"system"}
{
  "pinterestOptions": {
    "link": "https://www.ayrshare.com"
  }
}
```

## Pin Note

आप अपने बोर्ड्स पर व्यक्तिगत पिन में निजी नोट्स जोड़ सकते हैं। केवल आप और बोर्ड सहयोगी उन्हें देख पाएंगे।

`pinterestOptions` ऑब्जेक्ट में `note` का उपयोग करें।

```json Pin Note theme={"system"}
{
  "pinterestOptions": {
    "note": "Private note for collaborators"
  }
}
```

## Pinterest Image Carousel

Pinterest carousel के रूप में पाँच तक इमेज पोस्ट करें। एक से अधिक मीडिया URL जोड़ने से, एक carousel स्वचालित रूप से बन जाता है। आप वैकल्पिक carousel पैरामीटर भी जोड़ सकते हैं। कृपया नीचे देखें।

```json Pinterest Carousel Post theme={"system"}
{
  "post": "Carousel Time",
  "platforms": ["pinterest"],
  "mediaUrls": [
    "https://img.ayrshare.com/random/photo-1.jpg",
    "https://img.ayrshare.com/random/photo-2.jpg"
  ],
  "pinterestOptions": {
    "carouselOptions": [
      // optional
      {
        "title": "Image 1",
        "link": "https://www.cnn.com",
        "description": "Super Image 1"
      },
      {
        "title": "Image 2",
        "link": "https://www.google.com",
        "description": "Super Image 2"
      }
    ]
  }
}
```

वैकल्पिक `carouselOptions` फील्ड ऑब्जेक्ट्स की एक array लेता है। प्रत्येक carousel ऑब्जेक्ट संगत मीडिया URL स्ट्रिंग से मेल खाता है, उदाहरण के लिए पहला carousel ऑब्जेक्ट पहली `mediaUrl` स्ट्रिंग को संदर्भित करता है।

<ul class="custom-bullets">
  <li>`title`: इमेज का टाइटल।</li>
  <li>`link`: इमेज के लिए बाहरी डेस्टिनेशन लिंक।</li>
  <li>`description`: इमेज का विवरण।</li>
</ul>

## Pinterest Mentions

हालांकि आप Pinterest पोस्ट में @handle जोड़ सकते हैं, Pinterest पोस्ट टेक्स्ट में mentions को रिज़ॉल्व करने का समर्थन नहीं करता।
@handle सादे टेक्स्ट के रूप में बना रहेगा।

## Pin Title

प्रदर्शित करने के लिए पिन का टाइटल। यह नए पिन के "Add your title" सेक्शन में दिखाई देता है। अधिकतम 100 अक्षर।

`pinterestOptions` ऑब्जेक्ट में `title` का उपयोग करें।

```json Pin Title theme={"system"}
{
  "pinterestOptions": {
    "title": "A Pinterest Board for You"
  }
}
```

## Video Pin (Thumbnail)

एक वीडियो को [/post endpoint](/apis/post/post) में मानक `mediaUrls` फील्ड का उपयोग करके Pin के रूप में पोस्ट किया जा सकता है। इसके अतिरिक्त, वीडियो के साथ एक थंबनेल इमेज URL **शामिल करना आवश्यक है** जिसमें एक मान्य मीडिया Content-Type जैसे `image/jpeg` हो।
कृपया [requirements](/media-guidelines/pinterest) देखें।

```json Video Pin with Thumbnail theme={"system"}
{
  "pinterestOptions": {
    // required
    "thumbNail": "https://images.unsplash.com/photo-1513093496871-0a81425386e5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxNjQ1ODN8MHwxfHJhbmRvbXx8fHx8fHx8fDE2Mzg0ODAzNDA&ixlib=rb-1.2.1&q=80&w=400"
  }
}
```

[API का उपयोग करके Pins पोस्ट करने](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/) पर अतिरिक्त जानकारी।

यदि आपका वीडियो mp4 जैसे किसी ज्ञात वीडियो एक्सटेंशन में समाप्त नहीं होता है, तो कृपया `isVideo` पैरामीटर का उपयोग करें। विवरण के लिए [/post endpoint](/apis/post/post) देखें।