Images, videos, carousels and Reels
Media go in media as public (https) URLs. The type is inferred from the extension (.mp4, .mov, .webm are video), or you set it with "type": "image" or "video".
{ "text": "New menu", "platforms": ["instagram"], "media": [{ "url": "https://…/dish.jpg" }] }
What each network needs
| Network | Needs |
|---|---|
| an image or a video | |
| nothing (text only, or with media) | |
| TikTok | a video |
| nothing (text only, or with media) | |
| X | nothing (text only, or with media) |
| Threads | nothing (text only, or with media) |
| YouTube | a video |
| an image or a video |
If the media is missing, the media_required error tells you which network needs it and what to add.
Several media in one post
Send up to 10 items in media. Each network shows them in its own format; on Instagram, several images become a carousel.
Reels and Shorts
- Instagram: a video is published as a Reel. Use vertical format (9:16).
- YouTube: a short vertical video shows up as a Short.
- TikTok: always video, ideally vertical.
Preview
With the test key, the preview_url shows the first media item in each network's format: square for Instagram and Pinterest, feed for Facebook, LinkedIn, X and Threads, and vertical for TikTok and YouTube.