Image and video Pins on a board.
API id: pinterest
On Pinterest, each connected channel is a board. To pin to a different board, connect that board as its own channel.
At a glance
| Title | Optional, up to 100 characters. Send it as channels[].title. |
| Description | 800 characters (the block's content) |
| Files per post | Up to 5 images, or 1 video |
| File needed? | Yes |
| Threads | No |
| Alt text | Yes |
| Edit after publish | Yes — description, title and options |
| Delete after publish | Yes |
| Analytics | Impressions, saves, clicks |
| Comments | No. Pinterest does not offer this to apps. |
Files
| Type | Rules |
|---|---|
| Images (JPEG, PNG) | Up to 5 per Pin. |
| Video (MP4, MOV) | 1 per Pin, on its own. From 4 seconds to 5 minutes. Needs a cover_image. |
Options
| Key | Type | What it does |
|---|---|---|
link | url | Where people go when they click the Pin. Up to 2,048 characters. |
board_section_id | choice | Puts the Pin in a section of the board. Default: the board itself. |
cover_image | media | The still image shown before a video plays (JPEG or PNG). Required for video Pins. |
Example
{
"channelId": "CHANNEL_PINTEREST",
"title": "Easy pesto in 10 minutes",
"options": { "link": "https://example.com/recipes/pesto" },
"blocks": [
{
"content": "Fresh basil, garlic and pine nuts.",
"mediaIds": ["IMAGE_ID"],
"mediaAltText": { "IMAGE_ID": "A bowl of green pesto next to fresh basil" }
}
]
}Good to know
- Bulkit cannot pick a cover frame from a video for you, so always upload a
cover_imagefor a video Pin.
Set up
To connect accounts, you first need your own app on this platform. See the Pinterest app setup guide.