Download media
download_mediaCreate a temporary download of a public post. Returns a job object with status and, when done, download_url (valid 15 minutes) plus job_status_url to poll if it is still running after about 100 seconds. Use kind=video for MP4, audio for MP3, image for photo posts and carousels, thumbnail for the cover, frame for a still at one timestamp. For the spoken text use transcribe_video instead. Videos up to 12 hours. Only for content the user made, has permission to use, or that is freely licensed. Music is refused: songs, music videos, YouTube Music and copyrighted sounds return an error, do not try to work around it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "download_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Timestamp of the still for kind=frame. Time as '1:05', '0:01:05' or seconds ('65'). | |
| end | No | Optional end of the section, must be after start. Time as '1:05', '0:01:05' or seconds ('65'). | |
| url | Yes | Link to a public post or video, e.g. https://www.instagram.com/reel/..., https://www.tiktok.com/@user/video/..., https://youtu.be/... Private posts and login-only content fail. | |
| kind | No | What to save: video (MP4), audio (MP3), image (photo/carousel), thumbnail (cover image) or frame (one still, needs 'at'). | video |
| start | No | Optional start of a section to cut. Time as '1:05', '0:01:05' or seconds ('65'). | |
| quality | No | Maximum video height in pixels, e.g. 720, 1080, 2160. Omit for the best available. Only for kind=video. |