Quick start
Request
Response
The request returns a job right away: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
- Webhook
- Polling
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
Public media only
Public media only
Private, login-only, age-restricted, and password-protected media can’t be downloaded. See supported sites.
No playlists or live streams
No playlists or live streams
YouTube playlist pages are rejected; submit each video. Live streams fail until the stream has ended.
Downloads are capped by your balance
Downloads are capped by your balance
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.Links expire after 7 days
Links expire after 7 days
mediaUrl is signed for 7 days. Copy the file somewhere permanent, or use store: true to deliver it to your own bucket.Full reference: POST /import
Every parameter, the status endpoint, and response fields.