API Reference

Photos & Carousel

Multi-image posts and specifications

Max Images per Post

PlatformMax ImagesMixed Media?
Instagram10Yes (photos + videos)
Threads10Yes (photos + videos)
TikTok35 (photo slideshow)No (photos only)
Facebook10No
Pinterest5No
Bluesky4No
X (Twitter)4No

Image Specifications

PlatformRecommended SizeMax File SizeFormats
Instagram1080x13508 MBJPG, PNG
Threads8 MBJPG, PNG
TikTokJPG, JPEG, WEBP
Facebook10 MBJPG, PNG, GIF, WEBP
Pinterest1000x150020 MBJPG, PNG, GIF, WEBP
Bluesky1 MBJPG, PNG, GIF, WEBP
LinkedIn1200×6278 MBJPG, PNG, GIF

Alt Text

Alt text (accessibility descriptions) is supported on select platforms. Use the platform-specific field name:

PlatformFieldMax Characters
Instagraminstagram_alt_text1000
X (Twitter)x_alt_text1000
Blueskybluesky_alt_text1000
Pinterestpinterest_alt_text500

TikTok Photo Slideshow

TikTok automatically creates a photo slideshow when multiple images are posted. You can enable auto background music:

{
  "post_type": "image",
  "platforms": ["tiktok"],
  "media_urls": ["photo1.jpg", "photo2.jpg", "photo3.jpg"],
  "tiktok_auto_add_music": true
}