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.
