API Reference

Pinterest API

Create Pins, manage boards, and schedule Pinterest content with a single API call.

Get API Key Full Documentation

Quick Start

Get started in 3 steps

Get API Key

Connect Account

Use our OAuth flow to connect Pinterest accounts.

Start Posting

Make API calls to post content to Pinterest.

Create a Pinterest Pin

JavaScript

const response = await fetch('https://getlate.dev/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'

Endpoints

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 Specs

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

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

Rate Limits

API Limits

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

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

Capabilities

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

Response Example

Response

200 OK

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

Skip the Pinterest API complexity. Late handles OAuth, image optimization, and rate limits so you can ship faster.

Get Free API Key Read Documentation →

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