ShapelessAI← All specs

pinterestUnicode code pointsVerified by Tal Weiss

Pinterest character limit and media specs

A Pinterest post holds up to 800 characters, with 5 images, 1 video up to 5 min. Every number below is the one our publishing engine enforces before a Pinterest post goes out, with the source it came from and the date we last read it.

Text[text]

Pinterest text limits
Max length800 Unicode code points
CountingCounted in Unicode code points: one plain character is one, and a link costs its full length.

Media

Pinterest media constraints by kind
ConstraintImages[image]Video[video]
Per post51
Formats.png, .jpg, .jpeg.mp4, .mov, .m4v
Max size20 MB2 GB
Max length-5 min
We publish ityesyes

We publish text, images and video here; PDF documents we do not deliver to Pinterest yet. One post carries images or a video, never both. A post here cannot publish without image or video. A PDF deck degrades here into up to 5 slide images.

Mentions

No API-side tagging - plain text only.

The guidance our own agent carries for Pinterest, verbatim.

How our publisher handles it

The notes our publishing engine carries for Pinterest, verbatim - what our adapter does, not only what the platform allows.

  • Every pin needs a board (settings.boardId); title (max 100 chars) and link (max 2048) ride in settings.
  • One image, a 2-5 image carousel (all images the same width and height), or one 4 s - 5 min video.
  • Images upload as base64, which the API takes only as PNG or JPEG.
  • 2:3 aspect (1000x1500) recommended - other ratios get cropped in feed.
  • A Trial-access app pins to api-sandbox.pinterest.com and its pins are visible only to their creator; public pins need Standard access.

Questions

How long can a Pinterest post be?
800 characters. Counted in Unicode code points: one plain character is one, and a link costs its full length.
How many images can one Pinterest post have?
Up to 5: .png, .jpg, .jpeg, up to 20 MB each.
What video does Pinterest accept?
1 video per post: .mp4, .mov, .m4v, up to 2 GB each, up to 5 min.
How do you tag an account on Pinterest?
No API-side tagging - plain text only.

Sources, verified 2026-09-29

Each citation names where the number came from. Anything we could not confirm in an official document is marked, because a number nobody will stand behind should look different from one that is.

  1. [text]github.com/pinterest/api-description v5 openapi 5.28 PinCreate description<=800 title<=100 link<=2048; help.pinterest.com review-pin-specs 800github.com/pinterest/api-descriptionverified 2026-09-29
  2. [image]openapi 5.28 multiple_image_base64 items 2-5, base64 content_type image/jpeg|image/png; review-pin-specs 20MB web (2026-09-29); same-dimensions carousel rule from Postiz validation, not in official docsverified 2026-09-29no official doc confirms this number
  3. [video]openapi 5.28 media/create -> S3 form POST -> media/get status succeeded -> video_id pin; review-pin-specs 4s-5min organic; 2GB from pinterest-product-specs ad pageverified 2026-09-29
  4. [access]developers.pinterest.com key-concepts/access-tiers + developer-tools/sandbox: Trial pins visible only to creator, sandbox hostdevelopers.pinterest.comverified 2026-09-29