---
title: "Pinterest API"
description: "Use Ayrshare's Pinterest API to publish image pins, video pins, and carousels, schedule them, and get analytics for your users, without waiting on app review."
canonical: https://www.ayrshare.com/pinterest-api/
lastModified: 2026-11-17
pageType: landing
---

# Pinterest API

> Use Ayrshare's Pinterest API to publish image pins, video pins, and carousels, schedule them, and get analytics for your users, without waiting on app review.

## Pinterest API for Posting, Scheduling, and Analytics

Ayrshare's Pinterest API lets developers publish image Pins, video Pins, and carousels to Pinterest boards via a single REST endpoint. It supports scheduled Pins, titles and links, alt text, AI disclosures, board selection, and analytics across 14+ social networks through one integration.

Your users link their own Pinterest account and pick a default board inside your product, on Ayrshare's approved Pinterest app. You don't need your own Trial access, Standard access upgrade, or demo video.

[Read the Pinterest Docs](/docs/apis/post/social-networks/pinterest)
[Get Your API Key](/pricing/)

- **>99.99%** — API uptime
- **30M+** — API calls per day
- **14+** — Social media networks
- **AI-Native** — Native MCP server for any AI agent

## What Do You Need to Use the Pinterest API?

Pinterest API v5 is free to call, but publishing to your users' boards takes two approvals. You register an app from a Pinterest business account and apply for Trial access, reviewed each business day, but Trial Pins are sandbox Pins only their creator can see. Public Pins need Standard access, which takes a video of your app running the OAuth flow and a live Pinterest action. Pinterest publishes no turnaround time for that upgrade, and declined upgrades fill its developer forums.

With Ayrshare, you skip the Trial and Standard reviews: your users link their accounts and their Pins go out public on the same day.

- **Access**: A Pinterest business account, an app approved for Trial access, then a Standard access upgrade with a demo video. Pinterest declines upgrades whose video skips the OAuth flow, shows wireframes instead of a live integration, or signs users in any way other than OAuth.
- **Cost**: No fee for API v5 in either tier. The cost is the two reviews, the demo video, and keeping up with Pinterest's developer guidelines.
- **Account types**: The developer app must belong to a Pinterest business account. Pins go to boards on the account each user authorizes, one board per Pin.
- **Key limits**: Trial allows 1,000 requests a day per app, and only 300 a day for creating Pins and boards. Standard raises Pin and board writes to 100 requests per minute per user per app.

## Post and Schedule to Pinterest in Your Language

Each sample publishes an image Pin with a title, link, and alt text now, then schedules a video Pin to a specific board for later. Same endpoint, same JSON, in Node.js, Python, PHP, Java, Go, Ruby, C#, or plain cURL. Add a Profile-Key header to post for one of your users.

[Full Post API Reference](/docs/apis/post/overview)

- **cURL**
- **Node.js**
- **Python**
- **PHP**
- **Java**
- **Go**
- **Ruby**
- **C#**

## Pinterest API Limits: Post Types, Media, and Characters

Pinterest's rules in one place. The full list lives in the [Pinterest media guidelines](/docs/media-guidelines/pinterest) and the [Pinterest publishing options](/docs/apis/post/social-networks/pinterest).

- **3 Pin formats (Post types)**: Image Pins, video Pins, and image carousels. Pinterest's API doesn't accept text-only posts, so mediaUrls is required.
- **1 board per Pin (Accounts)**: One Pinterest account per user, with a default board chosen at linking. A boardId sends a Pin to any other board.
- **20 MB per image (Images)**: BMP, JPEG, PNG, TIFF, GIF, animated GIF, or WEBP. 2:3 aspect ratio, from 600 x 900 px to 2000 x 3000 px. 1000 x 1500 px is the recommended size.
- **15 min max length (Video)**: MP4, MOV, or M4V, up to 2 GB and at least 4 seconds, with an aspect ratio between 1.91:1 and 1:2. A thumbnail is required.
- **500 description characters (Characters)**: The description (the post field) can also be empty, and titles run to 100 characters. @handles stay plain text, since Pinterest doesn't resolve mentions.
- **2 to 5 images per carousel (Carousels)**: All images share the same dimensions, and each one gets its own title, link, and description.
- **2,048 characters per link (Links and alt text)**: URLs in the description aren't clickable, so set link in pinterestOptions to make the Pin open your page. Add alt text up to 500 characters per image or video, AI disclosure labels, and a private note of up to 1,000 characters.
- **300 API calls per 5 minutes per profile (Scheduling and limits)**: Pass a scheduleDate to publish later, and update or delete a scheduled Pin before it goes out. The 300-call limit is Ayrshare's.

## What Else Can You Do With the Pinterest API?

- **Post a carousel of 2 to 5 images**: Two to five image URLs become one carousel Pin. The optional carouselOptions array lines up with mediaUrls, so the first object describes the first image.
- **Publish a video Pin with a thumbnail**: Send the video in mediaUrls and the required thumbnail in pinterestOptions: PNG or JPG, the video's dimensions, under 10 MB. Add isVideo if the URL has no video extension.
- **Send a Pin to any board**: List the user's boards, then pass a board's id as boardId. Without it, the Pin goes to the default board.
- **Label AI-modified or synthetic content**: Pinterest accepts AI_MODIFIED and SYNTHETIC_PERFORMER for the whole Pin. An unknown or wrongly cased value still publishes the Pin, but Ayrshare drops the label and returns a warning.
- **Read Pin analytics**: Pass the Ayrshare post ID to get impressions, saves, clicks, profile visits, follows, and video views, 24 to 72 hours after the Pin publishes.

## Why Use Ayrshare Instead of the Pinterest API Directly?

Ayrshare runs the approved Pinterest app, so your product sends one request to the same [social media publishing API](/social-media-publishing-api/) it uses for every network and gets back the Pin ID and URL. Ayrshare handles the Pinterest authorization and board selection, checks media before it goes out, and uploads each video with its thumbnail. When Pinterest changes its API, the fix ships on our side, not in your sprint.

For a step-by-step walkthrough, read [How to Create Pins with an API](/blog/pinterest-api-integration-on-ayrshare/).

[See the Pinterest Publishing Options](/docs/apis/post/social-networks/pinterest)

- **Your app sends one request**: POST /post with the media URL and pinterestOptions, plus the user's Profile-Key.
- **Ayrshare runs the Pinterest flow**: Authorization, board selection, media checks, and video upload with its thumbnail.
- **The live Pin comes back**: The Pin ID and postUrl. The same Ayrshare id works for analytics, history, editing a scheduled Pin, and deletion.

## Beyond Posting: The Rest of the Pinterest Lifecycle

The same Pinterest connection reads analytics, pulls history, and checks Pins before they go out.

See every network you can reach with the same integration on the [supported networks page](/supported-networks/).

- **Analytics**: Per-Pin metrics plus board and profile totals with 90 days of daily detail, available 24 to 72 hours after publishing.
  - [Analytics API](/social-media-analytics-api/)
- **Edit and delete**: Update a scheduled Pin before it publishes, or delete scheduled and published Pins with the same Ayrshare post ID.
  - [Delete post docs](/docs/apis/post/delete-post)
- **History**: Pull a user's past Pins with their media, titles, links, and notes, including Pins created outside Ayrshare.
  - [History API](/history-api/)
- **Pre-publish checks**: Send the same JSON to /validate/post to catch a missing image, a long description, or a video without a thumbnail before anything reaches Pinterest.
  - [Validate docs](/docs/apis/validate/overview)
- **Not available on Pinterest**: Reading or replying to comments and direct messages, which Pinterest's API doesn't expose, and Pinterest ads, which Ayrshare's Ads API doesn't cover. Comment and reaction totals still appear in Pin analytics.

## FAQs About the Pinterest API

### Can I post to Pinterest through an API?

Yes, you can post to Pinterest through an API. Ayrshare's Pinterest API lets developers publish image Pins, video Pins, and carousels to Pinterest boards via a single REST endpoint. It supports scheduled Pins, titles and links, alt text, AI disclosures, board selection, and analytics across 14+ social networks through one integration. Start with the [Pinterest publishing options](/docs/apis/post/social-networks/pinterest).
### Is the Pinterest API free?

The Pinterest API is free in both the Trial and Standard tiers. The cost is access: Trial Pins stay private sandbox Pins, and public posting needs a Standard upgrade. Ayrshare's plans include public Pinterest posting on Ayrshare's approved app, so you can start posting without waiting on review. [Compare Ayrshare plans](/pricing/).
### How do I get Pinterest API approval?

To get Pinterest API approval, register an app from a Pinterest business account and apply for Trial access with an accurate privacy policy. Then select Upgrade in My apps and submit a video of your app's OAuth flow and a live Pinterest action. With Ayrshare, the approval is done, and the [Post API reference](/docs/apis/post/overview) shows the one request you need.
### How do I create Pins through the Pinterest API?

You create Pins through the Pinterest API by sending a description, an image or video URL, and any Pin options in one request. With Ayrshare, that's a POST to /post with pinterest in platforms and title, link, or boardId in pinterestOptions. The tutorial [How to Create Pins with an API](/blog/pinterest-api-integration-on-ayrshare/) walks through a first Pin.
### What can Pinterest API v5 do?

Pinterest API v5 can create and manage Pins and boards, read Pin and account analytics, and run ads, audiences, and catalogs. Through Ayrshare, you get publishing and analytics: image Pins, video Pins, carousels, boards, scheduling, history, and per-Pin metrics in the same JSON shape as every other network. See the [Analytics API](/social-media-analytics-api/) for the metrics you can read.
### Why was my Pinterest API access upgrade declined?

A Pinterest API access upgrade is usually declined because the demo video skips the OAuth flow, shows wireframes instead of a live integration, or the app collects passwords or session cookies. Pinterest wants the OAuth video even if you're the only user. Ayrshare's app already holds Standard access, so your users link through it instead. [See how Ayrshare links your users' accounts](/business-plan-for-multiple-users/).

## Your Users Are on Pinterest. Your Product Can Be Too.

Get an API key, publish your first Pin, and turn on the other networks with the same call when you need them.

[Get Your API Key](/pricing/)
[Read the Pinterest Docs](/docs/apis/post/social-networks/pinterest)
