Pinterest API

Pinterest's API requires app approval, separate board management endpoints, and image-specific upload flows. Zernio gives you one endpoint for Pins, boards, and scheduling.

Get API keyFull documentation
  • Free tier
  • No credit card
  • 99.97% uptime
A reading nook for small spaces
Nora HaleSave
Saturday 110:00 AMScheduled

Join 200,000+ of the world's most ambitious developers and builders

Warner Music Group
MoFlo
ClickUp
Readdy
RE/MAX
Moving Monkey®
How it works

Live in three steps, no Pinterest app review

1

Profile

default

Pinterest

Connect Pinterest

Sign up for free, get your API key and connect Pinterest accounts through our OAuth flow.

2

POST /v1/posts

const { data } = await zernio.posts.createPost({
  body: {
    content: 'Launch day board',
    mediaItems: [{ url: 'https://cdn.acme.com/launch.jpg' }],
    platforms: [
      { platform: 'pinterest', accountId: 'acc_8f2a' },
    ],
    scheduledFor: '2027-01-15T14:30:00',
    timezone: 'Europe/Madrid',
  },
});

Make one call

Send content to Pinterest from one REST endpoint, right away or scheduled.

3

post.failed

Webhook sent to your app

Failed

Mon, 18 Jan

09:00, Europe/Madrid

Scheduled

Launch day board

Fri, 15 Jan at 14:30

Published

Track every post

Follow each post from scheduled to published, with a webhook when one fails.

Endpoints

Pinterest endpoints on one REST API

EndpointWhat it does
POST/v1/postsCreate or schedule a new Pin (image or video)
GET/v1/posts/{id}Get status and details of a Pin
DELETE/v1/posts/{id}Cancel a scheduled Pin
GET/v1/profilesList all connected Pinterest accounts and boards
View full API reference
Media specs

What you can upload to Pinterest

Zernio transcodes and optimizes media for Pinterest's requirements automatically.

pinterest/media-specs
TypeFormatMax sizeNotes
ImageJPEG, PNG32 MB2:3 aspect ratio best
VideoMP4, MOV2 GB4 sec - 15 min duration
Idea PinJPEG, PNG, MP4Up to 20 pagesMulti-page storytelling
Capabilities

Everything the API handles for you

Pinterest's API has rate limits based on your app tier. Zernio manages these automatically, queuing pins when limits are approached.

Standard and video Pins

Create standard Pins and video Pins.

Scheduling

Schedule Pins for your best times.

Links and alt text

Add a destination link and alt text to every Pin.

Status webhooks

Get notified the moment a Pin publishes or fails.

Boards

Choose and manage the board each Pin lands on.

Rich Pins

Publish Rich Pins.

Multi-account

Manage several Pinterest accounts from one API key.

Response

What comes back from every call

Plain JSON back from every Pinterest call, with the IDs and statuses your app needs to follow up.

cURL

$ 

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "10 API Design Tips Every Developer Should Know",
    "platforms": [{
      "platform": "pinterest",
      "accountId": { "_id": "acc_abc123", "username": "yourpinterest" },
      "status": "published",
      "platformPostId": "1234567890123456789",
      "platformPostUrl": "https://pinterest.com/pin/1234567890123456789"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with the Pinterest API

Free tier available. No credit card required.

Get free API keyRead the docs
  • Free tier
  • No credit card
  • 99.97% uptime