Pinterest API

發布圖片 Pin 到 Pinterest

Pinterest API 要求貼文中必須包含圖片，其他參數則為選填。更多資訊請參閱 Pinterest 媒體指南與 Pinterest 授權。

Pinterest Post

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

Pinterest 選項

你可以透過 pinterestOptions 參數為貼文設定額外的選項。

Pinterest Post

{
  "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
    "aiDisclosures": ["AI_MODIFIED"],
    "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg",
    "title": "A Pinterest Board for You" // maximum 100 characters
  }
}

Pinterest 選項為可選欄位，用來控制貼文的呈現方式。

array of strings

圖片與影片的替代文字（alt text），為無障礙功能，可協助螢幕閱讀器讀取內容。最多 500 個字元。更多資訊請參閱 Pinterest 替代文字。

array of strings

為整個 Pin 宣告 AI 揭露資訊。可接受的值為 AI_MODIFIED 與 SYNTHETIC_PERFORMER。更多資訊請參閱 Pinterest AI 揭露。

string

透過指定 /user/details 端點回傳的 ID，將貼文發布到使用者另一個 Pinterest Board。若未指定，會發布到預設連結的 board。更多資訊請參閱 Pinterest Board ID。

array of objects

以 Pinterest 輪播 Pin 的形式最多發布 5 張圖片，並可為每張圖片加上選填的標題、連結與描述。每個物件可包含：title、link 與 description。更多資訊請參閱 Pinterest 圖片輪播。

string

使用者點擊該 Pin 圖片時會被導向的目的網址。最多 2048 個字元。會為你的 Pin 加上一個可點擊的連結。更多資訊請參閱 Pin 連結。

string

在個別 Pin 上加入私密備註，只有你和 board 的協作者能看到。最多 1000 個字元。更多資訊請參閱 Pin 備註。

string

為影片 Pin 設定縮圖。必須是 PNG 或 JPG 格式，尺寸與影片相同，並小於 10MB。影片 Pin 必填。更多資訊請參閱影片 Pin（縮圖）。

string

要顯示在「Add your title」區塊的 Pin 標題。最多 100 個字元。更多資訊請參閱 Pin 標題。

^*post 欄位中的連結無法點擊，請使用 link 欄位為 Pin 加上可點擊的連結。更多資訊請參閱 Pinterest 媒體指南。

替代文字

為 Pinterest 圖片或影片加上替代文字（alt text）。Pinterest 的 alt text 是一項無障礙功能，可提供額外的使用者資訊，並協助螢幕閱讀器讀取內容。請在 pinterestOptions 物件中使用 altText。

Pinterest Alt Text

{
  "pinterestOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

Alt text 上限為 500 個字元。

Pinterest AI 揭露

建立 Pin 時，使用 pinterestOptions.aiDisclosures 傳送 Pinterest 的 AI 揭露聲明。揭露資訊會套用至整個 Pin（包括圖片輪播），並支援圖片 Pin、輪播 Pin 與影片 Pin。

Pinterest AI Disclosure

{
  "post": "An AI-assisted concept for a garden studio",
  "platforms": ["pinterest"],
  "mediaUrls": ["https://example.com/garden-studio.jpg"],
  "pinterestOptions": {
    "aiDisclosures": ["AI_MODIFIED"]
  }
}

你可以同時傳送兩個可接受的值：

Pinterest AI Disclosure

{
  "pinterestOptions": {
    "aiDisclosures": ["AI_MODIFIED", "SYNTHETIC_PERFORMER"]
  }
}

可接受的值：

AI_MODIFIED：此 Pin 包含經 AI 修改的內容。
SYNTHETIC_PERFORMER：此 Pin 包含合成表演者。

若省略 aiDisclosures 或傳入空陣列，Ayrshare 不會向 Pinterest 傳送 AI 揭露欄位。重複的值只會傳送一次。值區分大小寫，且不會被自動轉換。若此選項無效，例如未知的值、大小寫錯誤、非陣列的值，或陣列中包含非字串項目，Pin 仍可能成功發布，但 Ayrshare 會略過整個揭露選項，並在 Pinterest 結果中回傳非致命警告。若 Pin 需要明確的 AI 揭露，請修正請求並傳送一個或兩個可接受的值。Pinterest 仍可能獨立套用其自身的標籤。 MCP 伺服器與 GraphQL API 會先檢查值的型別。在這些介面上，格式錯誤的值（例如包含數字的清單）會在發布前即被拒絕，而不是發布後附帶警告。未知或大小寫錯誤的字串仍會發布並附帶警告。

Board ID

透過指定從 /user/details 端點取得的 ID，將貼文發布到使用者另一個 Pinterest Board。否則會發布到預設連結的 board。請在 pinterestOptions 物件中使用 boardId。

Pinterest Board ID

{
  "pinterestOptions": {
    "boardId": "93383204522"
  }
}

字元限制

更多資訊請參閱 Pinterest 字元限制。

Pin 連結

使用者點擊你的 Pin 圖片時會被導向的目的網址。這會為你的 Pin 加上一個可點擊的連結。長度上限為 2048 個字元。請在 pinterestOptions 物件中使用 link。

Pin Link

{
  "pinterestOptions": {
    "link": "https://www.ayrshare.com"
  }
}

Pin 備註

你可以在 board 上的個別 Pin 加上私密備註，只有你和 board 的協作者能看到。請在 pinterestOptions 物件中使用 note。

Pin Note

{
  "pinterestOptions": {
    "note": "Private note for collaborators"
  }
}

Pinterest 圖片輪播

以 Pinterest 輪播 Pin 的形式發布最多五張圖片。當你加入多個媒體 URL 時，系統會自動建立輪播。你也可以加入選填的 carousel 參數（如下所示）。

Pinterest Carousel Post

{
  "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 欄位接受一個物件陣列。每個 carousel 物件會對應到相同順序的媒體 URL，例如第一個 carousel 物件對應第一個 mediaUrl 字串。

title：圖片標題。
link：該圖片指向的外部連結。
description：圖片描述。

Pinterest 提及

雖然你可以在 Pinterest 貼文中加入 @handle，但 Pinterest 不會解析貼文文字中的提及。 @handle 將保持為純文字顯示。

Pin 標題

要顯示的 Pin 標題。會出現在新 Pin 的「Add your title」區塊。最多 100 個字元。請在 pinterestOptions 物件中使用 title。

Pin Title

{
  "pinterestOptions": {
    "title": "A Pinterest Board for You"
  }
}

影片 Pin（縮圖）

可以透過 /post 端點的標準 mediaUrls 欄位以 Pin 形式發布影片。此外，必須同時提供一個有效的圖片縮圖 URL，且 Content-Type 需為 image/jpeg 等有效的媒體類型。需求請參閱規範。

Video Pin with Thumbnail

{
  "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 發布 Pin 的資訊。如果你的影片副檔名不是常見的影片格式（例如 mp4），請使用 isVideo 參數。詳情請參閱 /post 端點。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

發布圖片 Pin 到 Pinterest

Pinterest 選項

替代文字

Pinterest AI 揭露

Board ID

字元限制

Pin 連結

Pin 備註

Pinterest 圖片輪播

Pinterest 提及

Pin 標題

影片 Pin（縮圖）

​發布圖片 Pin 到 Pinterest

​Pinterest 選項

​替代文字

​Pinterest AI 揭露

​Board ID

​字元限制

​Pin 連結

​Pin 備註

​Pinterest 圖片輪播

​Pinterest 提及

​Pin 標題

​影片 Pin（縮圖）

發布圖片 Pin 到 Pinterest

Pinterest 選項

替代文字

Pinterest AI 揭露

Board ID

字元限制

Pin 連結

Pin 備註

Pinterest 圖片輪播

Pinterest 提及

Pin 標題

影片 Pin（縮圖）