Image Pins
One image up to 5 MB, with a title, description and alt text.
uploadIdsPinterest API
The Pinterest API for image & video Pins
Create image and video Pins on any of your boards, with a title, description, alt text and a destination link, in one request.
What you can publish
Every Pinterest format, one endpoint
The same request that posts everywhere else, with the fields Pinterest needs and nothing it doesn't.
Video Pins
Video from 4 seconds to 15 minutes, up to 2 GB, with a custom cover.
thumbnailDestination links
Send every Pin somewhere — a product page, a recipe, an article.
linkAny board
Pick the board by name from the connected account's boards.
boardNameBeyond publishing
More than a way to post to Pinterest
Everything around the post — when it goes out, how it performs, where else it lands — through the same API.
Scheduling
Schedule Pinterest posts to the minute
Give a post a time and Bulkit publishes it then. Queue a week — or a quarter — of Pinterest content in one go, and let retries and rate limits take care of themselves.
- Any time zone
- Retries built in
- Rate limits handled
Analytics
Pinterest analytics, in one schema
Profile metrics over 30 days, plus per-Pin metrics. Only video Pins have true view counts. Same response shape as every other network, so there's nothing to reconcile.
- Impressions
- Saves
- Video views
- Pins
- Followers
Cross-posting
Pinterest and 11 more networks in one call
Add targets to the same request and one payload fans out everywhere, with each network getting the fields it needs. Upload media once and reuse it on every channel.
- One API key
- One schema
- No per-network fees
AI agents
Let your AI agent post to Pinterest
Bulkit's MCP server gives Claude, Cursor or any MCP-compatible agent real tools to publish and schedule to Pinterest — the same actions your code calls.
- Claude & Cursor
- Scoped API keys
- Every call logged
Pinterest at a glance
The Pinterest API's sharp edges, filed down
| Spec | |
|---|---|
| Formats | Image Pin, video Pin |
| Title | Up to 100 characters |
| Description | Up to 800 characters |
| Image | 1 image, up to 5 MB |
| Video | 4s–15 min, up to 2 GB, 1:2 to 1.91:1 |
| Alt text | Up to 500 characters |
| Analytics | Impressions, saves, video views, followers |
Boards by name
Target a board with boardName, read from the connected account, rather than looking up IDs first.
Video that fits
Pinterest takes video from 4 seconds to 15 minutes between 1:2 and 1.91:1. The limits are documented per field.
Accessible Pins
altText and a note travel with the Pin, so descriptions for screen readers aren't an afterthought.
Saves as the signal
Saves come back as likes in the shared analytics schema, alongside impressions and video views.
FAQ
Pinterest API: common questions
Can I schedule Pinterest Pins with the API?
Yes. Create a Pin with a board, media and link, give it a postDate, and Bulkit publishes it at that time.
Does the API support video Pins?
Yes. Videos from 4 seconds to 15 minutes, up to 2 GB, with aspect ratios between 1:2 and 1.91:1. You can attach a custom cover.
How do I choose the board?
Set boardName to one of the connected account's boards. Each Pin goes to one board.
What Pinterest analytics are available?
Profile impressions, video views, saves, Pin count and followers over 30 days, plus per-Pin metrics. Only video Pins have true view counts.
How much does it cost?
$4.99/month with 500 actions included, then $0.01 per action. Pinterest is included with every other network.
Your first Pinterest post is one request away
$4.99/mo with 500 actions included, then $0.01 each. Pinterest and every other network on the same key.