Options for posting via the API to Pinterest

Pinterest API Endpoint


Pinterest requires an image to be included in the post. Videos are not yet supported by Pinterest. Other parameters are optional.
  • title: The title of the pin to display. This appears in the "Add your title" section of a new pin. Maximum characters allowed: 100.
  • link: The clickthrough link URL when the image is clicked.
  • boardId: Post to another one of the user's Pinterest Boards by specifying the ID obtained from the /user/details endpoint. Otherwise post to the default linked board.
"post": "The best Pinterest API ever!",
"platforms": ["pinterest"],
"mediaUrls": [""],
"pinterestOptions": {
"title": "A Pinterest Board for You", // optional
"link": "", // optional
"boardId": "93383204522" // optional

Posting a Pinterest Video Pin

A video may be posted as a Pin using the standard mediaUrls field in the /post endpoint. Additionally, a thumbnail image URL must be included with the video. Please see requirements.
"pinterestOptions": {
"thumbNail": ""
Additional information on posting Pins using the API.
If your video doesn't end in a known video extension such as mp4, please use the isVideo parameter. See the /post endpoint for details.

Alternative Text

Add alternative text, also known as alt text, to a Pinterest image or video. Pinterest alt text is an accessibility feature used for additional user info and screen readers.
Use the altText in the pinterestOptions object.
"pinterestOptions": {
"altText": "This is my best pic", "😃 here is the next one"
The alt text is limited to 500 characters.
Last modified 1mo ago