Skip to main content

Pinterest videos: Format requirements

Florian Triller-Windisch avatar
Written by Florian Triller-Windisch
Updated over a month ago

Video-Upload API requirements

In order to successfully publish a video or a picture via Swat.io, the uploaded file must meet the specifications required by the interface (API).

Note: Swat.io has no control over the requirements of the interface, as the APIs are provided and managed directly by the respective social medias. Accordingly, the requirements vary depending on the platform.

What happens in case of a non-compliant upload?

If you upload a file to Swat.io that does not meet the requirements of the API, you will see a blue notification banner directly in Publisher:

This notification is intended to inform you that the file does not meet the specifications of the respective platform. In most cases, it will also provide specific details on which file specifications need adjustment for the upload to be successful.

Note: Video posts without a thumbnail image cannot be approved or published in Swat.io due to a necessity as per the API of Pinterest.

Video-Specifications

In order to successfully publish a video via the API we received from Pinterest, the video file must comply with the following specifications

Aspect ratio

For standard videos min. 1.91:1 and max. 1:2;

For max. width videos, 1:1 (square) or 16:9 (widescreen) is supported.

Format

mp4, mov or m4v

Video-codec

H.264 or H.265

File size

Maximum 2 GB

Duration

between 4 seconds and 15 minutes

Please ensure that the uploaded file complies with all the above requirements.

Important: If one or more of these requirements are not met, the file will not be accepted by the social media's API and therefore cannot be published. In this case, you will receive a corresponding error message in the activity log after the upload failed.

Duration and processing time

  • The upload and publishing process on Pinterest can take up to approx. 30 minutes or more, as the platform first internally processes the uploaded files.

  • Swat.io regularly checks if Threads has finished processing, then automatically publishes the video.

  • If no confirmation from the social media is received within approx. 30 minutes, the upload will be marked as failed in the post's activity log.

Info: Once transferred to the social media platform, Swat.io no longer has any control over the upload process.

Note on Pinterest's policies

Please also adhere to the Pinterest community-guidelines, to ensure your content does not violate any rules. In particular:

  • Do not violate any copyright without permission;

  • No glorification of violence or discriminating content;

  • No hate speech or other inappropriate content.

Violations of these guidelines may result in the removal of your video from the platform or restrictions of your account on the respective platform.

Did this answer your question?