Pinterest API

Pinterest Posting API

Create pins, target boards, and drive traffic from Pinterest programmatically. PostPeer handles Pinterest's API for you.

Pin creation with image uploads
Board targeting
Link attribution for traffic
Scheduled pin publishing

Start Posting for Free View Docs

No credit card required.

POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin"], "content": "Hello world!" }

Published

5 platforms

TwitterLinkedInFacebook+2

All posts delivered

Scheduled

queue

Queued

847

Sent

Next: in 15 min

Platforms

connected

XIGFBLITT

One API, every platform

How It Works

Add social media to your product in three steps.

Get Your API Key

Sign up and get your API key instantly — no sales calls, no complex onboarding.

Integrate in Minutes

A single endpoint to post, schedule, and manage content. Drop it into your product and go.

Your Users Post Everywhere

Your product now supports every major social platform — without you maintaining a single integration.

API Response Format

Clean, structured JSON that's easy to parse and integrate

Request

POST

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",
    "mediaItems": [
      { "url": "https://cdn.example.com/pin-image.jpg", "type": "image" }
    ],
    "platforms": [
      {
        "platform": "pinterest",
        "accountId": "acc_pin_111",
        "platformSpecificData": {
          "boardId": "board_abc",
          "link": "https://example.com/design-tips"
        }
      }
    ]
  }'

Response

JSON

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

Everything You Need for Pinterest Publishing

Create and manage pins programmatically without dealing with Pinterest's API directly.

Pin Creation

Create pins with images, titles, and descriptions. PostPeer handles Pinterest's pin creation API.

Board Targeting

Publish pins to specific boards. Pass the boardId in platformSpecificData to target the right board.

Link Attribution

Attach a destination URL to every pin. Drive traffic from Pinterest back to your site or product.

Image Optimization

PostPeer validates image dimensions and format against Pinterest's requirements for optimal display.

Scheduled Publishing

Schedule pins for future publication. Time your content for Pinterest's peak engagement hours.

Cross-Post to Other Platforms

Share the same visual content on Pinterest + Instagram + Facebook in a single API request.

More Platform APIs

Twitter / X Instagram YouTube YouTube Shorts

Frequently Asked Questions

Ready to Add Social Media to Your Product?

One API. Every platform. Start building with free credits.

Start Posting for FreeNo credit card required.