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

用于无障碍和屏幕阅读器的图片和视频替代文本。最多 500 个字符。更多信息请参见 Pinterest 替代文本。

array of strings

为整个 Pin 声明 AI 披露。可接受的值为 AI_MODIFIED 和 SYNTHETIC_PERFORMER。更多信息请参见 Pinterest AI 披露。

string

通过指定 /user/details 端点获取的 ID，发布到用户的其他 Pinterest 看板。如果未指定，将发布到默认关联的看板。更多信息请参见 Pinterest 看板 ID。

array of objects

将最多 5 张图片作为 Pinterest 轮播添加，可选包含标题、链接和描述。每个对象可以包含：title、link 和 description。更多信息请参见 Pinterest 图片轮播。

string

用户点击 Pin 图片时将被引导到的目标 URL。最多 2048 个字符。在你的 Pin 上创建一个可点击的链接。更多信息请参见 Pin 链接。

string

为单个 Pin 添加私人备注，只有你和看板协作者可以查看。最多 1000 个字符。更多信息请参见 Pin 备注。

string

为视频 Pin 设置缩略图。必须为 PNG 或 JPG，与视频尺寸相同，大小不超过 10MB。视频 Pin 必填。更多信息请参见视频 Pin（缩略图）。

string

Pin 的标题，显示在 “Add your title” 部分。最多 100 个字符。更多信息请参见 Pin 标题。

^*post 字段中的链接不可点击。请使用 link 字段为 Pin 添加可点击的链接。更多信息请参见 Pinterest 媒体指南。

替代文本

为 Pinterest 图片或视频添加替代文本（也称为 alt text）。Pinterest 替代文本是一项无障碍功能，用于提供附加的用户信息并支持屏幕阅读器。在 pinterestOptions 对象中使用 altText。

Pinterest Alt Text

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

替代文本限制为 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 会先检查值的类型。在这些接口上，格式错误的值（例如包含数字的列表）会在发布前被拒绝，而不是带着警告发布。未知或大小写错误的字符串仍会发布并附带警告。

看板 ID

通过指定从 /user/details 端点获取的 ID，发布到用户的其他 Pinterest 看板。否则发布到默认关联的看板。在 pinterestOptions 对象中使用 boardId。

Pinterest Board ID

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

字符限制

更多信息请参见 Pinterest 字符限制。

Pin 链接

用户点击你的 Pin 图片时将被引导到的目标 URL。这会在你的 Pin 上创建一个可点击的链接。最大长度为 2048 个字符。在 pinterestOptions 对象中使用 link。

Pin Link

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

Pin 备注

你可以为你看板上的单个 Pin 添加私人备注。只有你和看板协作者可以看到它们。在 pinterestOptions 对象中使用 note。

Pin Note

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

Pinterest 图片轮播

将最多五张图片作为 Pinterest 轮播发布。通过添加多个媒体 URL，会自动创建轮播。你还可以添加可选的轮播参数。请见下方。

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 字段接受一个对象数组。每个轮播对象对应等效的媒体 URL 字符串，例如，第一个轮播对象引用第一个 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 披露

看板 ID

字符限制

Pin 链接

Pin 备注

Pinterest 图片轮播

Pinterest 提及

Pin 标题

视频 Pin（缩略图）

​发布图片 Pin 到 Pinterest

​Pinterest 选项

​替代文本

​Pinterest AI 披露

​看板 ID

​字符限制

​Pin 链接

​Pin 备注

​Pinterest 图片轮播

​Pinterest 提及

​Pin 标题

​视频 Pin（缩略图）

发布图片 Pin 到 Pinterest

Pinterest 选项

替代文本

Pinterest AI 披露

看板 ID

字符限制

Pin 链接

Pin 备注

Pinterest 图片轮播

Pinterest 提及

Pin 标题

视频 Pin（缩略图）