API Reference

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 Key Full Documentation

Quick Start

1.
Get API Key
Sign up for free and get your API key in seconds.
2.
Connect Account
Use our OAuth flow to connect Pinterest accounts.
3.
Start Posting
Make API calls to post content to Pinterest.

Create a Pinterest Pin

JavaScript

const response = await fetch('https://zernio.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: '10 API Design Tips Every Developer Should Know',
    mediaItems: [{ type: 'image', url: 'https://example.com/infographic.png' }],
    platforms: [{
      platform: 'pinterest',
      accountId: 'acc_abc123',
      platformSpecificData: {
        boardId: 'board_xyz789',
        link: 'https://example.com/blog/api-design-tips'
      }
    }],
    publishNow: true
  })
});

const post = await response.json();
console.log(post.post._id); // '65f1c0a9e2b5af0012ab34cd'

Pinterest Endpoints

POST/v1/posts

Create 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/profiles

List all connected Pinterest accounts and boards

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Image	JPEG, PNG	32 MB	2:3 aspect ratio best
Video	MP4, MOV	2 GB	4 sec - 15 min duration
Idea Pin	JPEG, PNG, MP4	Up to 20 pages	Multi-page storytelling

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

API Limits

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

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

✓Create standard Pins and video Pins
✓Schedule Pins for optimal times
✓Board management and selection
✓Link and alt text support
✓Multi-account management
✓Webhook notifications for pin status
✓Rich Pin support

Response Example

Response

JSON

{
  "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 Pinterest API

Free tier available · No credit card required · 99.97% uptime

Get Free API Key Read Documentation →