Download media from a URL
import_mediaDownload video or audio from any URL to hosted storage and get a direct link, with an optional transcript. Returns a jobId to poll for the result.
Instructions
Download the video/audio at any URL (YouTube, TikTok, X, and 1000+ sites) to hosted storage and get back a direct download link. Async: returns a jobId immediately; poll check_import for the result. Optionally also produce a transcript in the same job with includeTranscript. If the credit balance doesn't cover the requested videoQuality, it downloads at the highest quality the balance covers and check_import names the quality used. Runs the same job as POST /import in the REST API, so it doubles as a test call while building downloads into the user's app; for that app code, call get_integration_guide.
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": "import_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Media page URL, e.g. https://www.youtube.com/watch?v=... | |
| audioQuality | No | Default medium | |
| includeAudio | No | Include audio stream (default true) | |
| includeVideo | No | Include video stream (default true) | |
| videoQuality | No | Default 720p. Drops to the highest quality the credit balance covers when it can't pay for this one | |
| maxCostDollars | No | Most this request may cost in total, in dollars (download plus transcript), at least 0.01. If it would cost more, nothing is downloaded and the job fails with MAX_COST_EXCEEDED and the price, for a $0.003 price check | |
| compatibleCodecs | No | Prefer H.264 video and AAC audio, which play everywhere (Safari, iOS, editors), over smaller AV1/VP9 files at the same resolution. Default false | |
| includeTranscript | No | Also transcribe the audio in the same job | |
| transcriptLanguage | No | ISO language hint for the transcript, e.g. "en" |