Skip to main content

X video 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.

Required specifications of the X API

X videos

Format

.mp4, .mov

Audio codec

AAC low complexity (AAC LC), 48khz maximum, mono oder stereo

Video codec

h264, fixed frame rate, progressive

Closed GOP (2-5 seconds)

4:2:0 chroma-subsampling

Frame rate

Max. 60 fps

Resolution

Recommended 1280x720 px (wide), 720x1280 (portrait) and 720x720 px (square)

Aspect ratio

Between 1:3 and 3:1

Video bitrate

Min. 5 mbps

Audio bitrate

Max. 128 kbps

Length

min. 5 seconds, max. 140 seconds

File size

Max. 512 MB

These guidelines ensure that content is optimized for mobile viewing and social networking on Threads, maintaining a balance between quality and loading process.

Important: Please make sure that your file upload meets all criteria mentioned above before starting the publication of the post. Otherwise, the video will be rejected by the API and will not be published. In this case a corresponding error message will appear in Swat.io's >>>>>activity log<<<<<.

LINK!!!!!!!

Duration and processing time

  • The upload and publishing process on X 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 X 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 X' policies

Please also adhere to the X 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?