Image and Video Posting Requirements

When posting to the /post endpoint, it is important to note the following requirements. Please only select either a video or image(s) since no social network support posting a video and images in the same post.

Accepted File Types

Files have an accepted file ending type (extension), such as jpg, jpeg, png, webp, gif, mp4, mov, or avi, with content-types such as image/jpeg or video/mp4.

If the media URL has special characters, e.g. ñ, please encode the special characters before sending.

Please see below for details on each network.

Maximum Images

Max images accepted per platform in a single post:

  • Facebook Pages: 10 images, including a carousel post.
  • Instagram: 10 images.
  • Google Business Profile: 1 image.
  • LinkedIn: 9 images.
  • Pinterest: 1 image.
  • Reddit: 1 image.
  • Telegram: 1 image.
  • TikTok: 35 images.
  • X/Twitter: 4 images.

Maximum Videos

Only one video is allowed per post for X/Twitter, Facebook, LinkedIn, Instagram, Pinterest, TikTok, YouTube, and Telegram. Reddit does not yet support videos.

Please be sure your video URL ends in an accepted video extension such as .mp4 or .mov, depending upon the network.

For example,

We recommend for larger video files over 50 MB create a scheduled post with the scheduleDate parameter for async processing.

Be sure to also check the upload speed of your media URLs to prevent timeouts at the social networks. If the media file can not be downloaded within approximately 5 minutes a time out will likely occur.

Standard Social Video Requirements

Each social network has different requirement videos. If you want a video that can be published to social networks such as X/Twitter, Instagram, Facebook, and TikTok use the following standards:

Dimensions: 1280 x 720 px

Length: 60 seconds

Size: 50 MB

Format: MP4

Example Portrait Video: https://img.ayrshare.com/random/portrait5.mp4

You may also create specific sized video for networks such as YouTube that accept longer and larger files. Please see below for details of each network.

See how to create random videos for your testing.

Content Type

When posting, be sure the content-type is set appropriately, e.g. image/png, image/jpg, or image/jpeg.

Secure URLs

When posting your own media URL, the link must be secure by using SSL and starting with https://

Social Network Details