Skip to main content
Downloading from YouTube or TikTok is easy from your laptop and unreliable from a server. Datacenter IPs get blocked, sites change how they serve video, and the streams you get back usually need ffmpeg to merge. Importly gives you a link to the finished file instead, and it works the same from a server, a CI job, or an agent sandbox.

Quick start

Request

Response

The request returns a job right away:
When the job finishes, your webhook receives the file details:
mediaUrl is a signed link to the file on Importly storage. It expires after 7 days, so copy the file somewhere permanent, or set store: true to have it copied to your bucket.

Options

Every parameter, including the transcript and storage options, is in the POST /import reference.
You’re billed for downloadedBytes, the bytes pulled from the source, not the size of the file you get. They differ for audio-only imports from platforms with no separate audio stream (common on TikTok): Importly downloads the smallest video and extracts the audio, so downloadedBytes is larger than fileSizeBytes.

Quality

Each setting is a ceiling. Importly picks the best stream at or below it.

Getting the result

Pass webhookUrl and Importly sends one POST to it when the job succeeds. The result fields sit directly on data, as in the example above. Failed jobs don’t send a webhook, and there are no retries, so keep polling as a fallback. Payloads for every job type are on Webhooks.

Pricing

Downloads cost $0.01 per MB downloaded, rounded up to the next MB, with a $0.03 minimum per import. You’re charged only when the import succeeds. To spend less, lower videoQuality, or set includeVideo: false when you only need the audio. See Pricing & credits for every price.

Limits

Private, login-only, age-restricted, and password-protected media can’t be downloaded. See supported sites.
YouTube playlist pages are rejected; submit each video. Live streams fail until the stream has ended.
An import never downloads more than your remaining credit can pay for. If the file is bigger, the job fails with FILE_TOO_LARGE; add credits or choose a lower quality.

Full reference: POST /import

Every parameter, the status endpoint, and response fields.