# 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"`.

```json
{ "text": "New menu", "platforms": ["instagram"], "media": [{ "url": "https://…/dish.jpg" }] }
```

## What each network needs

| Network | Needs |
| --- | --- |
| Instagram | an image or a video |
| Facebook | nothing (text only, or with media) |
| TikTok | a video |
| LinkedIn | nothing (text only, or with media) |
| X | nothing (text only, or with media) |
| Threads | nothing (text only, or with media) |
| YouTube | a video |
| Pinterest | 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.
