Postproxy × Pinterest

Create pins on Pinterest with images and videos. Drive traffic with destination links and organized boards.

One API call handles Pinterest pins with media uploads and board targeting.

Board Targeting

Pin directly to specific boards for organized content

Traffic Driver

Add destination links to drive traffic from pins to your website

Video Pins

Upload video pins up to 2 GB and 15 minutes long

Custom Covers

Set custom cover images and thumbnail offsets for video pins

POST /v1/posts
Terminal window
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "10 Tips for Better Photography"
       },
       "profiles": ["pinterest"],
       "media": ["https://example.com/image.jpg"],
       "platforms": {
         "pinterest": {
           "title": "10 Tips for Better Photography",
           "board_id": "987654321",
           "destination_link": "https://example.com/blog/photography-tips"
         }
       }
     }'

Pinterest Parameters

Formats

Format Description
pin Pin (default)

Parameters

Parameter Type Required Description
title string No Title of the pin
board_id string Yes ID of the public board to pin to
destination_link string No URL of the destination link
cover_url string No URL of cover image (video only)
thumb_offset integer No Thumbnail image offset in seconds (video only)

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 32 MB jpg, gif, png, webp 1 -
Video 2 GB mp4, mov 1 4s - 15min

Notes

  • Text content: Optional (description)
  • Media required: Yes
  • Mix video and image: No

View full documentation for all platform-specific features for Pinterest

View documentation

Why Postproxy for Pinterest?

Skip Pinterest API complexity

No need to handle Pinterest API, OAuth flows, or rate limits. Postproxy handles it all.

Board management simplified

Target specific boards by ID without managing Pinterest's board API separately.

Cross-platform publishing

Publish the same visual content to Pinterest alongside Instagram, TikTok, and more in one API call.

Reliable delivery

Automatic retries and clear status reporting ensure your pins reach Pinterest.

How Pinterest Publishing Works with Postproxy

Pinterest's publishing model

Pinterest's API creates Pins — visual bookmarks that link to external URLs. Unlike other social platforms where content lives natively, every Pin is designed to drive traffic somewhere. The API requires a board ID (where the Pin is saved), media (image or video), and supports optional fields like title, description, alt text, and a destination link. Postproxy maps your content to Pinterest's Pin creation endpoint, handling board selection and media formatting.

Image pins, video pins, and Idea Pins

Standard Pins support a single image or video with a destination link. Video Pins use a different upload flow that requires registering the media first, uploading it, then creating the Pin with the media reference. Pinterest also supports Idea Pins (multi-page story-like content), though API support for these is more limited. Postproxy handles the media upload flow for both image and video pins, detecting the type from your media URLs.

Common gotchas Postproxy handles for you

Pinterest's API has strict image requirements: recommended 2:3 aspect ratio (1000x1500px), minimum 100x100px, and a 20MB file size limit. Video Pins have a 2GB limit but require specific codecs (H.264 video, AAC audio). The API rate-limits per user and per app, with different limits for read and write operations. Pinterest also requires board IDs (not names) for Pin creation, which means an extra API call to list boards if you only know the board name. Postproxy validates media constraints and resolves board names to IDs automatically.

SEO, alt text, and destination links

Pinterest is unique among social platforms because Pins are indexable by search engines and Pinterest's own visual search. Alt text, Pin titles, and descriptions all contribute to discoverability both on Pinterest and in Google image search. Destination links drive referral traffic — making Pinterest one of the highest-ROI social channels for content marketing. Postproxy lets you set all these fields per Pin, ensuring your content is optimized for both Pinterest's algorithm and external search.

Frequently Asked Questions

Common questions about Pinterest integration

Is a board_id required for Pinterest pins?

Yes, you must specify a board_id to indicate which public board the pin should be added to.

What media formats does Pinterest support?

Pinterest supports images (jpg, gif, png, webp) up to 32 MB and videos (mp4, mov) up to 2 GB with a duration of 4 seconds to 15 minutes.

Can I add a link to my Pinterest pin?

Yes! Use the destination_link parameter to add a clickable link to your pin that drives traffic to your website or landing page.

Can I set a custom thumbnail for video pins?

Yes, you can use cover_url to set a custom cover image, or thumb_offset to select a frame from the video at a specific second.

Can I post text-only content on Pinterest?

No, Pinterest requires at least one image or video for every pin. The post body becomes the pin description.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.

Get started View documentation