The Pinterest API built for developers
Create image and video Pins on Pinterest with one API call — no board bookkeeping, no media registration, no token expiry. We run the Pinterest API so you ship in hours, not weeks.
✓ 5 minutes to first pin ✓ 99.92% uptime ✓ Image & video Pins
curl https://api.outstand.so/v1/posts/ \
-H "Authorization: Bearer $OUTSTAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Summer lookbook 2026 ☀️",
"accounts": ["pinterest"],
"media": [{ "url": "https://media.outstand.so/look.jpg", "filename": "look.jpg" }],
"pinterest": { "board_id": "987654321", "link": "https://example.com/lookbook" }
}'Every Pin needs a board_id. Add a destination link, title and alt text in the same call.
Pinterest's API is powerful — and fiddly
Creating Pins through the Pinterest API v5 means an app and OAuth, trial access that is heavily rate-limited until you upgrade to standard, and a required board_id on every Pin. Destination links, titles and alt text are separate fields to manage. Outstand turns all of it into a single request.
Everything Pinterest supports, through one endpoint
Every content type and capability available on Pinterest via Outstand today.
Image Pins
Video Pins
Destination links
Boards
Plus destination links, Pin titles and alt text. Reading or replying to comments is not offered by Pinterest’s API.
Copy, paste, ship
The same accounts array also fans out to Instagram, X, LinkedIn and more — one request, many platforms.
Create a video Pin
curl https://api.outstand.so/v1/posts/ \
-H "Authorization: Bearer $OUTSTAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "How we styled the summer drop 🎬",
"accounts": ["pinterest"],
"media": [{ "url": "https://media.outstand.so/style.mp4", "filename": "style.mp4" }],
"pinterest": { "board_id": "987654321", "link": "https://example.com/shop" }
}'Add a title & alt text
curl https://api.outstand.so/v1/posts/ \
-H "Authorization: Bearer $OUTSTAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Summer lookbook 2026",
"accounts": ["pinterest"],
"media": [{ "url": "https://media.outstand.so/look.jpg", "filename": "look.jpg" }],
"pinterest": {
"board_id": "987654321",
"title": "Summer Lookbook 2026",
"alt_text": "A model in a red summer dress on a beach"
}
}'Schedule a Pin (up to 30 days out)
curl https://api.outstand.so/v1/posts/ \
-H "Authorization: Bearer $OUTSTAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Drops Friday ☀️",
"accounts": ["pinterest"],
"media": [{ "url": "https://media.outstand.so/teaser.jpg", "filename": "teaser.jpg" }],
"pinterest": { "board_id": "987654321" },
"scheduledAt": "2026-07-03T16:00:00Z"
}'Read analytics
curl https://api.outstand.so/v1/posts/{id}/analytics \
-H "Authorization: Bearer $OUTSTAND_API_KEY"
# → impressions, saves, pin_clicks, outbound_clicksLive in three steps
From signup to your first published Pin in about five minutes.
Connect Pinterest
Your user authorizes via OAuth. We store and refresh the token. Use our approved Managed Keys, or bring your own app.
Call POST /v1/posts/
Send media with accounts: ["pinterest"] and a pinterest.board_id. Add a link, title or alt text, or scheduledAt to schedule.
We do the Pinterest API work
Pin creation, media handling, link attachment and retries — returned as a unified response with the published Pin ID.
More than a Pinterest wrapper
One integration that grows with everything you ship next.
One API, 10+ platforms
One request publishes to Pinterest and 10 more networks. Same JSON shape everywhere — learn one API, ship them all.
Managed Keys or BYOK
Use our approved Pinterest app for full throughput, or bring your own once you have standard API access.
Built for scale
Intelligent rate limiting, automatic token refresh, webhook events and media processing.
Honest pricing
$19/mo includes 3,000 posts, then from $0.007/post. No seats, no annual lock-in.
What you can build
Same endpoints, same data shapes — pick what you ship.
Social schedulers
Let your users queue and auto-publish Pinterest content from your app.
AI agents
Give Claude or GPT a tool to post to Pinterest. MCP server included.
Analytics dashboards
Pull Pinterest reach and engagement alongside every other platform.
Agencies & white-label
Run Pinterest posting for clients under your own brand and app.
Pinterest API FAQ
The questions developers ask before they build.
Does Pinterest have an official API?
Yes — the Pinterest API v5 lets approved apps create Pins, manage boards and read analytics. Outstand is a managed layer on top of it, so you skip the app approval and media plumbing.
Can I create Pins via API?
Yes. Send media to POST /v1/posts/ with accounts: ["pinterest"] and a pinterest.board_id. Outstand uploads the media and creates the Pin on that board.
Do I need a board ID to create a Pin?
Yes — Pinterest requires a board_id on every Pin. Pass it in the pinterest options block and Outstand publishes the Pin to that board.
Can I add a destination link to a Pin?
Yes. Set pinterest.link to the URL the Pin should open when clicked. You can also set a title and alt_text in the same call.
Can I create video Pins via the API?
Yes. Send a video file in the media array with a board_id and Outstand creates a video Pin.
Can I schedule Pins via the API?
Yes. Add a scheduledAt ISO-8601 timestamp (up to 30 days ahead) and Outstand publishes the Pin automatically — no cron or queue on your side.
Can I delete a Pin via the API?
Yes. Pinterest supports deleting Pins via the API, and Outstand exposes it through DELETE /v1/posts/{id}/remote.
Ship Pinterest Pins today
Grab an API key and create your first Pin in the next five minutes. 3,000 posts included, then from $0.005/post.