Pinterest

Overview

Create pins with images, target specific boards, and drive traffic with link attribution. PostPeer handles Pinterest's API and OAuth.

Status: Coming soon. Pinterest integration is currently in development.

Quick Start

1. Connect a Pinterest Account

curl https://api.postpeer.dev/v1/connect/pinterest \
  -H "x-access-key: YOUR_API_KEY"

Returns a Pinterest OAuth URL.

2. Create a Pin

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "10 design tips for modern landing pages",
    "platforms": [
      {
        "platform": "pinterest",
        "accountId": "pin_111",
        "platformSpecificData": {
          "boardId": "board_abc",
          "link": "https://example.com/design-tips"
        }
      }
    ],
    "mediaItems": [
      { "type": "image", "url": "https://cdn.example.com/pin-image.jpg" }
    ],
    "publishNow": true
  }'

Response:

{
  "success": true,
  "status": "published",
  "postId": "post_vwx234",
  "platforms": [
    {
      "platform": "pinterest",
      "success": true,
      "platformPostUrl": "https://www.pinterest.com/pin/98765/"
    }
  ]
}

Platform-Specific Data

Field	Type	Description
`boardId`	string	Target board for the pin
`link`	string	Destination URL for traffic attribution
`altText`	string	Alt text for accessibility

Media Requirements

Type	Formats	Recommended Size
Image	JPG, PNG, WebP	1000x1500px (2:3 ratio)

Pinterest requires at least one image per pin.